Skip to main content
GET
Returns every Target visible to the API key’s organization. This is a metadata and job-progress list; it does not return member rows. Reading it also reconciles auto-admission: Targets with auto_admit: true can have existing proposed members promoted and generated lists synchronized. A Target member is in Monitoring only when its status is watching. proposed and excluded members remain part of the Target but are not monitored.

Request

No path, query, or body parameters.
Every Target route requires Authorization: Bearer <api key>. A platform key must also send X-FreshTalent-Org-Id with a UUID. The organization must have active access.

Response

200 OK returns { "data": Target[], "meta": { "count": integer } }. There is no server pagination or next URL for this endpoint; meta.count is the number of returned Targets. Each Target has this shape: The service orders Targets by created_at descending.

Examples

Errors and recovery

  • 401 unauthorized: missing, invalid, or revoked API key. Fix authentication.
  • 400 invalid_request: a platform key is missing X-FreshTalent-Org-Id or the header is not a UUID. Fix the header.
  • 402 payment_required: the organization is locked after its trial. Subscribe before retrying.
  • 429 or 5xx: use bounded backoff and honor Retry-After for 429. Reads are safe to retry; do not assume a failed response means the collection was empty.

Next