---
title: "Changes to Retrieve a source"
method: GET
path: "/v1/projects/{projectID}/sources/{sourceID}"
---

# Changes to Retrieve a source

`GET /v1/projects/{projectID}/sources/{sourceID}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 14 of 106 revisions.

- **2026-07-20** (v3) `bae289777c91`: 15 breaking, 13 warning, 6 info
- **2026-07-19** (v3) `e171f744d209`: 1 breaking
- **2026-06-18** (v3) `274ed78eabfc`: 1 info
- **2026-01-23** (v3) `623f857d89a5`: 1 info
- **2024-04-04** (v3) `317ec51848e3`: 3 info
- **2024-03-26** (v3) `28d285e4302c`: 4 warning, 1 info
- **2024-02-08** (v3) `8aa5161aec4c`: 1 warning, 1 info
- **2023-11-17** (v3) `41d4fca4cab8`: 1 warning, 1 info
- **2023-07-28** (v3) `2fc887538896`: 1 warning
- **2023-06-22** (v3) `5c862889f0b4`: 2 info
- **2023-06-01** (v3) `546f4792c61c`: 9 info
- **2023-05-28** (v3) `36284be114fe`: 1 info
- **2023-05-10** (v3) `297818aad550`: 8 warning
- **2023-04-21** (v3) `196c93bf2075`: 1 info

## Changes

- **2026-07-20** (v3) `bae289777c91`: 15 breaking, 13 warning, 6 info
  - the response property `allOf[subschema #2]/data` became nullable for the status `400`
  - the response property `allOf[subschema #2]/data` became nullable for the status `401`
  - the response property `allOf[subschema #2]/data` became nullable for the status `404`
  - the response property `allOf[subschema #2]/data/body_function` became nullable for the status `200`
  - the response property `allOf[subschema #2]/data/deleted_at` became nullable for the status `200`
  - the response property `allOf[subschema #2]/data/header_function` became nullable for the status `200`
  - the response property `allOf[subschema #2]/data/provider_config` became nullable for the status `200`
  - the response property `allOf[subschema #2]/data/pub_sub` became nullable for the status `200`
  - the response property `allOf[subschema #2]/data/verifier` became nullable for the status `200`
  - the `allOf[subschema #2]/data` response's property type changed from `object` to no type for status `400`
  - the `allOf[subschema #2]/data` response's property type changed from `object` to no type for status `401`
  - the `allOf[subschema #2]/data` response's property type changed from `object` to no type for status `404`
  - the `allOf[subschema #2]/data/provider_config` response's property type changed from `object` to no type for status `200`
  - the `allOf[subschema #2]/data/pub_sub` response's property type changed from `object` to no type for status `200`
  - the `allOf[subschema #2]/data/verifier` response's property type changed from `object` to no type for status `200`
  - removed the optional property `allOf[subschema #2]/data/provider_config/twitter` from the response with the `200` status
  - removed the optional property `allOf[subschema #2]/data/pub_sub/amqp` from the response with the `200` status
  - removed the optional property `allOf[subschema #2]/data/pub_sub/google` from the response with the `200` status
  - removed the optional property `allOf[subschema #2]/data/pub_sub/kafka` from the response with the `200` status
  - removed the optional property `allOf[subschema #2]/data/pub_sub/sqs` from the response with the `200` status
  - removed the optional property `allOf[subschema #2]/data/pub_sub/type` from the response with the `200` status
  - removed the optional property `allOf[subschema #2]/data/pub_sub/workers` from the response with the `200` status
  - removed the optional property `allOf[subschema #2]/data/verifier/api_key` from the response with the `200` status
  - removed the optional property `allOf[subschema #2]/data/verifier/basic_auth` from the response with the `200` status
  - removed the optional property `allOf[subschema #2]/data/verifier/hmac` from the response with the `200` status
  - removed the optional property `allOf[subschema #2]/data/verifier/type` from the response with the `200` status
  - added the new `` enum value to the `allOf[subschema #2]/data/provider` response property for the response status `200`
  - added the new `` enum value to the `allOf[subschema #2]/data/type` response property for the response status `200`
  - added `#/components/schemas/datastore.ProviderConfig` to the `allOf[subschema #2]/data/provider_config` response property `allOf` list for the response status `200`
  - added `#/components/schemas/datastore.PubSubConfig` to the `allOf[subschema #2]/data/pub_sub` response property `allOf` list for the response status `200`
  - added `#/components/schemas/datastore.VerifierConfig` to the `allOf[subschema #2]/data/verifier` response property `allOf` list for the response status `200`
  - added `#/components/schemas/handlers.Stub` to the `allOf[subschema #2]/data` response property `allOf` list for the response status `400`
  - added `#/components/schemas/handlers.Stub` to the `allOf[subschema #2]/data` response property `allOf` list for the response status `401`
  - added `#/components/schemas/handlers.Stub` to the `allOf[subschema #2]/data` response property `allOf` list for the response status `404`
- **2026-07-19** (v3) `e171f744d209`: 1 breaking
  - the `allOf[subschema #2]/data/pub_sub/google/service_account` response's property type changed from `array` to `string`, and format from no format to `byte` for status `200`
- **2026-06-18** (v3) `274ed78eabfc`: 1 info
  - added the optional property `allOf[subschema #2]/data/event_type_location` to the response with the `200` status
- **2026-01-23** (v3) `623f857d89a5`: 1 info
  - added the optional property `allOf[subschema #2]/data/pub_sub/sqs/endpoint` to the response with the `200` status
- **2024-04-04** (v3) `317ec51848e3`: 3 info
  - added the optional property `allOf[subschema #2]/data/body_function` to the response with the `200` status
  - added the optional property `allOf[subschema #2]/data/header_function` to the response with the `200` status
  - added the optional property `allOf[subschema #2]/data/pub_sub/amqp/vhost` to the response with the `200` status
- **2024-03-26** (v3) `28d285e4302c`: 4 warning, 1 info
  - removed the optional property `allOf[#/components/schemas/util.ServerResponse]/data` from the response with the `200` status
  - removed the optional property `allOf[#/components/schemas/util.ServerResponse]/data` from the response with the `400` status
  - removed the optional property `allOf[#/components/schemas/util.ServerResponse]/data` from the response with the `401` status
  - removed the optional property `allOf[#/components/schemas/util.ServerResponse]/data` from the response with the `404` status
  - api operation id `GetSource` was added
- **2024-02-08** (v3) `8aa5161aec4c`: 1 warning, 1 info
  - added the new `amqp` enum value to the `allOf[subschema #2]/data/pub_sub/type` response property for the response status `200`
  - added the optional property `allOf[subschema #2]/data/pub_sub/amqp` to the response with the `200` status
- **2023-11-17** (v3) `41d4fca4cab8`: 1 warning, 1 info
  - added the new `kafka` enum value to the `allOf[subschema #2]/data/pub_sub/type` response property for the response status `200`
  - added the optional property `allOf[subschema #2]/data/pub_sub/kafka` to the response with the `200` status
- **2023-07-28** (v3) `2fc887538896`: 1 warning
  - removed the optional property `allOf[subschema #2]/data/idempotency_ttl` from the response with the `200` status
- **2023-06-22** (v3) `5c862889f0b4`: 2 info
  - added the optional property `allOf[subschema #2]/data/idempotency_keys` to the response with the `200` status
  - added the optional property `allOf[subschema #2]/data/idempotency_ttl` to the response with the `200` status
- **2023-06-01** (v3) `546f4792c61c`: 9 info
  - added the optional property `allOf[subschema #2]/data/created_at` to the response with the `200` status
  - added the optional property `allOf[subschema #2]/data/deleted_at` to the response with the `200` status
  - added the optional property `allOf[subschema #2]/data/forward_headers` to the response with the `200` status
  - added the optional property `allOf[subschema #2]/data/mask_id` to the response with the `200` status
  - added the optional property `allOf[subschema #2]/data/project_id` to the response with the `200` status
  - added the optional property `allOf[subschema #2]/data/provider_config` to the response with the `200` status
  - added the optional property `allOf[subschema #2]/data/uid` to the response with the `200` status
  - added the optional property `allOf[subschema #2]/data/updated_at` to the response with the `200` status
  - added the optional property `allOf[subschema #2]/data/url` to the response with the `200` status
- **2023-05-28** (v3) `36284be114fe`: 1 info
  - added the optional property `allOf[subschema #2]/data/custom_response` to the response with the `200` status
- **2023-05-10** (v3) `297818aad550`: 8 warning
  - removed the optional property `allOf[subschema #2]/data/created_at` from the response with the `200` status
  - removed the optional property `allOf[subschema #2]/data/deleted_at` from the response with the `200` status
  - removed the optional property `allOf[subschema #2]/data/mask_id` from the response with the `200` status
  - removed the optional property `allOf[subschema #2]/data/project_id` from the response with the `200` status
  - removed the optional property `allOf[subschema #2]/data/provider_config` from the response with the `200` status
  - removed the optional property `allOf[subschema #2]/data/uid` from the response with the `200` status
  - removed the optional property `allOf[subschema #2]/data/updated_at` from the response with the `200` status
  - removed the optional property `allOf[subschema #2]/data/url` from the response with the `200` status
- **2023-04-21** (v3) `196c93bf2075`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/getconvoy/apis/convoy-api-reference/docs/v1/projects/:projectID/sources/:sourceID/get.md) - [API](https://skmtc.dev/getconvoy/apis/convoy-api-reference.md) - [Page](https://skmtc.dev/getconvoy/apis/convoy-api-reference/changes/v1/projects/:projectID/sources/:sourceID/get)
