---
title: "Get source details"
method: GET
path: "/api/v1/external/sources/{sourceId}"
tags: ["Sources"]
---

# Get source details

`GET /api/v1/external/sources/{sourceId}`

## Request

- Base URL: `https://api.wove.com`
- URL: `https://api.wove.com/api/v1/external/sources/{sourceId}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/wove/apis/wove-external-api/docs/api/v1/external/sources/:sourceId/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns detailed information about a specific source, including processing status and any errors.

## Path parameters

- `sourceId` string, required

## Response `200`

Source details retrieved successfully

- object
  - `success` boolean
  - `data` ExternalSourceDetail
    - `id` string
    - `filename` string
    - `status` 'awaiting_upload' | 'pending' | 'processing' | 'complete' | 'failed'
    - `sourceType` 'contract' | 'spot' | 'tariff'
    - `carrierId` string
    - `carrierName` string
    - `rateCount` integer
    - `effectiveDate` string, date
    - `expiryDate` string, date
    - `description` string
    - `createdAt` string, date-time
    - `processedAt` string, date-time
    - `error` string, nullable: Error message if processing failed

## Other responses

- `404`: Source not found

---

[API](https://skmtc.dev/wove/apis/wove-external-api.md) - [All operations](https://skmtc.dev/wove/apis/wove-external-api/llms.txt) - [OpenAPI document](https://skmtc.dev/wove/apis/wove-external-api/revisions/37290e267e07?raw)