List a source's mappings
The source's mappings, one per header set its files have had, newest first. A run that stopped as needs_mapping waits for its proposed one.
- Scopes
sources:read - Rate classread
/v1/sources/{id}/mappingsThe source's mappings, one per header set its files have had, newest first. A run that stopped as needs_mapping waits for its proposed one.
Authorization
apiKey An API key (fo_live_… / fo_test_…) as a bearer token
In: header
Path Parameters
Source (a vendor connection) ID
^src_[0-9A-Za-z]{22}$Query Parameters
Page size
1 <= value <= 10020Opaque position returned by a previous page
^[A-Za-z0-9_-]{1,512}$Opaque position returned by a previous page
^[A-Za-z0-9_-]{1,512}$Header Parameters
Dated API version; pinned per organisation on first use and overridable per request
Value in
- "2026-10-01"
- "2026-10-04"
The data the request acts on: test is the organisation's sandbox. An OAuth token picks it (live by default); an API key's mode is fixed, and naming the other one is refused
Value in
- "live"
- "test"
ETag of a cached representation; a match returns 304
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X GET "https://example.com/v1/sources/string/mappings"{ "object": "list", "data": [ { "object": "mapping", "id": "string", "source": "string", "status": "proposed", "headers": [ "string" ], "samples": [ [ "string" ] ], "columns": [ { "column": "string", "prefix": true, "field": "group", "settings": {}, "tier": "built_in" } ], "unmapped": [ { "column": "string", "reason": "string" } ], "confirmed_at": "2019-08-24T14:15:22Z", "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z" } ], "has_more": true, "next_cursor": "string"}