---
title: "Get Source by ID with Expanded References"
method: GET
path: "/data_sources/{source_id}?expand=1"
tags: ["Sources"]
---

# Get Source by ID with Expanded References

`GET /data_sources/{source_id}?expand=1`

## Request

- Base URL: `https://dataops.nexla.io/nexla-api`
- URL: `https://dataops.nexla.io/nexla-api/data_sources/{source_id}?expand=1`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/nexla/apis/nexla-rest-api/docs/data_sources/:source_id%3Fexpand=1/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a source object along with advanced information about associated references if a valid ID is provided.

## Path parameters

- `source_id` integer, required

## Query parameters

- `expand` 1: Add this parameter to a resource fetch request to receive details about related resources in the response.

## Headers

- `Accept` 'application/vnd.nexla.api.v1+json' | 'application/json': Setting to `application/vnd.nexla.api.v1+json` is recommended.

## Response `200`

Success

- object
  - `id` integer
  - `owner` Owner
    - `id` integer
    - `full_name` string
    - `email` string, email
  - `org` Org
    - `id` integer
    - `name` string
    - `email_domain` string
    - `email` unknown
    - `client_identifier` unknown
  - `access_roles` string[]: This property reflects all the permissions the user/team/organization has to this resource. 1. `collaborator`: The user/team/organization can view the resource but not make any modifications to it. 2. `operator`: The user/team/organization can view the resource and can activate/pause it, but not make any other modifications to it. 3. `administrator`: The user/team/organization has complete administrative rights to this resource. 4. `owner`: This user created the resource and so has complete administrative rights to it.
  - `name` string
  - `description` unknown
  - `status` string
  - `data_sets` object[]
    - `version` integer
    - `id` integer
    - `owner_id` integer
    - `org_id` integer
    - `name` string
    - `description` string
    - `updated_at` string, date-time
    - `created_at` string, date-time
    - `sample_service_id` unknown
    - `source_schema` DataSetSchema
      - `properties` object
      - `$schema` string, url
      - `$schema-id` integer
    - `transform` object
      - `version` integer
      - `data_maps` unknown[]
        - unknown
      - `transforms` unknown[]
        - unknown
      - `custom_config` object
    - `output_schema` DataSetSchema
      - `properties` object
      - `$schema` string, url
      - `$schema-id` integer
  - `ingest_method` string
  - `source_format` string
  - `source_config` object
  - `poll_schedule` unknown
  - `managed` boolean
  - `code_container_id` unknown
  - `source_type` string
  - `connector_type` string
  - `connector` object
    - `id` integer
    - `type` string
    - `connection_type` string
    - `name` string
    - `description` string
    - `nexset_api_compatible` boolean
  - `api_keys` unknown[]
    - unknown
  - `auto_generated` boolean
  - `data_credentials` object
    - `id` integer
    - `name` string
    - `description` string
    - `owner` Owner
      - `id` integer
      - `full_name` string
      - `email` string, email
    - `org` Org
      - `id` integer
      - `name` string
      - `email_domain` string
      - `email` unknown
      - `client_identifier` unknown
    - `access_roles` string[]: This property reflects all the permissions the user/team/organization has to this resource. 1. `collaborator`: The user/team/organization can view the resource but not make any modifications to it. 2. `operator`: The user/team/organization can view the resource and can activate/pause it, but not make any other modifications to it. 3. `administrator`: The user/team/organization has complete administrative rights to this resource. 4. `owner`: This user created the resource and so has complete administrative rights to it.
    - `credentials_version` string
    - `managed` boolean
    - `credentials_type` string
    - `connector` object
      - `id` integer
      - `type` string
      - `connection_type` string
      - `name` string
      - `description` string
      - `nexset_api_compatible` boolean
    - `api_keys` unknown[]
      - unknown
    - `credentials_non_secure_data` object
    - `verified_status` string
    - `verified_at` string, date-time
    - `copied_from_id` unknown
    - `updated_at` string, date-time
    - `created_at` string, date-time
    - `tags` unknown[]
      - unknown
  - `run_ids` object[]
    - `id` integer
    - `created_at` string, date-time
  - `copied_from_id` unknown
  - `updated_at` string, date-time
  - `created_at` string, date-time
  - `flow_type` string
  - `ingestion_mode` string
  - `tags` unknown[]
    - unknown

## Other responses

- `403`: Forbidden
- `404`: Not found

---

[API](https://skmtc.dev/nexla/apis/nexla-rest-api.md) - [All operations](https://skmtc.dev/nexla/apis/nexla-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nexla/apis/nexla-rest-api/revisions/ef02be92fe7b?raw)