> ## Documentation Index > Fetch the complete documentation index at: https://docs.deck.co/llms.txt > Use this file to discover all available pages before exploring further. # Retrieve a Source > Returns details for a specific data source identified by its source_id ## OpenAPI ````yaml /api-reference/v1.json get /sources/{sourceId} openapi: 3.0.4 info: title: Deck API description: "# Deck API makes it straightforward for users to connect to any portal securely and quickly.\r\n\r\n### Welcome! Looking for a quick introduction to our API? Check out the 🚀[Quickstart guide](https://docs.deck.co/guides/guides/quickstart).\r\n\r\nGetting started is easy:\r\n\r\n1. Create an account using the [dashboard](https://dashboard.deck.co) to get your client id and secret\r\n2. Enter your client id and secret in the Authentication section below\r\n3. Hit the \"Try\" buttons below for each endpoint.\r\n\r\nHappy querying!" contact: name: Ready to start building? Contact us! url: https://deck.co version: v1 servers: - url: https://live.deck.co/api/v1 description: Deck API - url: https://sandbox.deck.co/api/v1 description: Deck Sandbox API (Enterprise only) security: [] tags: - name: Agents description: Agent management - name: Connection description: Manage connections - name: Connections description: Endpoints for creating and managing workflow connections. - name: Decks description: Endpoints related to decks. - name: Jobs description: Endpoints related to jobs. - name: Sources description: Endpoints for managing and searching data sources - name: Link description: >- These endpoints are used by the Link widget. They can also be used for creating your own UX experience and connecting data from utility data sources. paths: /sources/{sourceId}: get: tags: - Sources summary: Retrieve a Source description: Returns details for a specific data source identified by its source_id operationId: v1_getSource parameters: - name: sourceId in: path required: true schema: type: string format: uuid responses: '200': description: OK content: application/json: schema: $ref: >- #/components/schemas/Datadeck_Api_WebModels_Models_Api_V1_Source_SourceItemResponse text/json: schema: $ref: >- #/components/schemas/Datadeck_Api_WebModels_Models_Api_V1_Source_SourceItemResponse application/json+encrypted: schema: $ref: >- #/components/schemas/Datadeck_Api_WebModels_Models_Api_V1_Source_SourceItemResponse '400': description: Bad Request content: application/json: schema: $ref: >- #/components/schemas/Datadeck_Common_WebModels_Models_ErrorMessageResponse text/json: schema: $ref: >- #/components/schemas/Datadeck_Common_WebModels_Models_ErrorMessageResponse application/json+encrypted: schema: $ref: >- #/components/schemas/Datadeck_Common_WebModels_Models_ErrorMessageResponse '401': description: Unauthorized - Invalid API key '404': description: Not Found content: application/json: schema: $ref: '#/components/schemas/Microsoft_AspNetCore_Mvc_ProblemDetails' text/json: schema: $ref: '#/components/schemas/Microsoft_AspNetCore_Mvc_ProblemDetails' application/json+encrypted: schema: $ref: '#/components/schemas/Microsoft_AspNetCore_Mvc_ProblemDetails' security: - client_id: [] secret: [] components: schemas: Datadeck_Api_WebModels_Models_Api_V1_Source_SourceItemResponse: required: - id - logo_url - name - url type: object properties: id: type: string description: Unique external identifier for the source format: uuid name: type: string description: Name of the data source url: type: string description: Website URL of the data source logo_url: type: string description: URL to the source's logo image auth_supported: type: boolean description: Indicates whether the source supports user authentication additionalProperties: false Datadeck_Common_WebModels_Models_ErrorMessageResponse: type: object properties: error_category: allOf: - $ref: >- #/components/schemas/Datadeck_Api_Application_Models_Exceptions_Api_ErrorCategoryEnum description: A broad categorization of the error. Safe for programmatic use. error_code: allOf: - $ref: >- #/components/schemas/Datadeck_Api_Application_Models_Exceptions_Api_ErrorCodeEnum description: The particular error code. Safe for programmatic use. error_message: type: string description: >- A developer-friendly representation of the error code. This may change over time and is not safe for programmatic use. display_message: type: string description: >- A user-friendly representation of the error code. null if the error is not related to user action. This may change over time and is not safe for programmatic use. nullable: true additionalProperties: false Microsoft_AspNetCore_Mvc_ProblemDetails: type: object properties: type: type: string nullable: true title: type: string nullable: true status: type: integer format: int32 nullable: true detail: type: string nullable: true instance: type: string nullable: true additionalProperties: {} Datadeck_Api_Application_Models_Exceptions_Api_ErrorCategoryEnum: enum: - INVALID_REQUEST - INVALID_RESULT - INVALID_INPUT - DATA_SOURCE_ERROR - RATE_LIMIT_EXCEEDED - API_ERROR - CONNECTION_ERROR - RECAPTCHA_ERROR - FETCH_BALANCE - ADD_PAYMENT_METHOD - FETCH_PAYMENT_METHODS - PAYMENT type: string Datadeck_Api_Application_Models_Exceptions_Api_ErrorCodeEnum: enum: - DATA_SOURCE_NOT_FOUND - DATA_SOURCE_NOT_RESPONDING - PRODUCT_NOT_READY - CONNECTION_NOT_FOUND - CONNECTION_FAILED - INVALID_CREDENTIALS - LIVE_CONNECTIVITY_NOT_ENABLED - PRODUCT_NOT_ENABLED - NO_ACCOUNTS - NO_STATEMENTS - CONNECTION_LOCKED - BLOCKED_BY_PIN - VALIDATION_FAILED - INVALID_API_KEYS - INVALID_LINK_TOKEN - INVALID_PUBLIC_TOKEN - INVALID_ACCESS_TOKEN - INVALID_ACCOUNT_ID - INVALID_STATEMENT_ID - CONSENT_REQUIRED - INVALID_CURP - INVALID_DOCUMENT_UPLOAD - INVALID_ARGUMENT - INPUT_VALUES - NOT_SUPPORTED - UNEXPECTED_ERROR - PLANNED_MAINTENANCE - SECURITY_QUESTION_NOT_FOUND - SECURITY_CAPTCHA_NOT_FOUND - RATE_LIMIT_EXCEEDED - NO_ACTIVE_CONNECTION - INVALID_SOURCE - ACTIVE_CONNECTION_EXISTS - DOMAIN_BLACKLISTED - NO_JOB_FOUND - DECK_NOT_FOUND - DECK_JOB_NOT_FOUND - JOB_DEFINITION_NOT_FOUND - FORBIDDEN - IDEMPOTENCY_KEY_INVALID - IDEMPOTENCY_KEY_DUPLICATE - CORRELATION_ID_INVALID - JOB_CANNOT_BE_CANCELED - JOB_NOT_RUNNING - NO_EVENT_FOUND type: string securitySchemes: client_id: type: apiKey description: Enter your client id name: x-deck-client-id in: header secret: type: apiKey description: Enter your secret name: x-deck-secret in: header ````