---
title: "Get Sources"
method: GET
path: "/sources"
---

# Get Sources

`GET /sources`

Lists sources in the Isometric system

## Query parameters

- `supplier_reference_id` string, nullable — A string that must be unique for all resources created by a specific supplier. It can be used by a client to identify the correct objects in their system.
- `project_id` string
- `last` integer — An integer number of items to retrieve before the item represented by the cursor passed in the before parameter. Defaults to 10 with a maximum value of 50.
- `before` string, nullable — An opaque cursor representing the first item in the previously requested page to select items ordered before it. Submit the previously requested page’s start_cursor here when paginated backwards.
- `first` integer — An integer number of items to retrieve after the item represented by the cursor passed in the after parameter. Defaults to 10 with a maximum value of 50.
- `after` string, nullable — An opaque cursor representing the last item in the previously requested page to select items ordered after it. Submit the previously requested page’s end_cursor here when paginated forwards.

## Headers

- `x-client-secret` string, required — A secret token identifying the client connecting to the API

## Response `200`

Successful Response

- PaginatedListResourceSource
  - `nodes` Source[], required
    - `id` string, required
    - `supplier_reference_id` string, nullable, required — A string that must be unique for all resources created by a specific supplier. It can be used by a client to identify the correct objects in their system.
    - `display_name` string, nullable, required
    - `description` string, nullable, required
    - `original_filename` string, nullable, required
    - `type` 'DOCUMENT' | 'WEBSITE', required
    - `published_at` string, date, nullable, required
    - `url_info` union, required — URL info for the source, that varies depending on if it is public or private
      - SourcePublicUrlInfo
        - `__typename` 'SourcePublicUrlInfo' — Contains the name of the model (formally, OpenAPI Schema Object). Used to determine the type of data, for example when two different types are unioned.
        - `url` string, required
      - SourcePrivateUrlInfo
        - `__typename` 'SourcePrivateUrlInfo' — Contains the name of the model (formally, OpenAPI Schema Object). Used to determine the type of data, for example when two different types are unioned.
        - `is_accessible` boolean, required — This field indicates whether or not a private source visible to the caller. If it is, to get a temporary pre-signed url that will allow the caller to view the source, make a request to the "/sources/{id}/private_url" endpoint.
    - `is_public` boolean, required — This field indicates Whether or not this source document will be public on the Registry once Credits are issued referencing it.
    - `project_id` string, nullable, required — The ID of the project that the source is associated with.
  - `total_count` integer, required
  - `page_info` PageInfo, required
    - `has_previous_page` boolean, required
    - `start_cursor` string, nullable, required
    - `has_next_page` boolean, required
    - `end_cursor` string, nullable, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/isometric/apis/isometric-certify-data-ingestion-api.md) · [All operations](https://skmtc.net/isometric/apis/isometric-certify-data-ingestion-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/isometric/isometric-certify-data-ingestion-api/versions/9819e9c8ccf0/schema)