---
title: "List Sources"
method: GET
path: "/v1/sources"
tags: ["sources"]
---

# List Sources

`GET /v1/sources`

## Request

- Base URL: `https://sandboxapi.givechariot.com`
- URL: `https://sandboxapi.givechariot.com/v1/sources`
- Auth: HTTP bearer

Returns the sources visible to your organization: the canonical sources
Chariot maintains, plus any custom sources your organization has added.

## Query parameters

- `limit` integer
- `page_token` string
- `scope` 'canonical' | 'custom'

## Response `200`

The response for Sources.list

- object
  - `results` Source[]
    - `id` string, required: The unique identifier for the source.
    - `name` string, required: The human-readable name of the source.
    - `scope` 'canonical' | 'custom', required: Who owns this source. - `canonical` — maintained by Chariot and shared across every organization. Read-only. - `custom` — created by an organization for its own use, and mutable by that organization.
    - `logo` string, uri, nullable: URL of the source's logo, if one is available.
    - `created_at` string, date-time, required: When this source was added to the directory.
    - `updated_at` string, date-time, required: When this source was last modified.
  - `next_page_token` string: A cursor token to retrieve the next page of results. If specified, more results exist on the server; otherwise the list has been exhausted.

## Other responses

- `400`: The request is invalid or contains invalid parameters
- `401`: Unauthorized. The request is missing the security (OAuth2 Bearer token) requirements and the server is unable to verify the identify of the caller.
- `403`: Access denied
- `500`: Internal Server Error

---

[API](https://skmtc.dev/chariot-giving/apis/chariot-api-5.md) - [All operations](https://skmtc.dev/chariot-giving/apis/chariot-api-5/llms.txt) - [OpenAPI document](https://skmtc.dev/chariot-giving/apis/chariot-api-5/revisions/d2a4ff2fdda5?raw)