Skip to main content
GET
Returns one saved query belonging to the authenticated organization. The ID is the UUID returned by Save query or List saved queries; it is not a name lookup.
string
required
Saved-query UUID. There is no alternate name form and no pagination parameter.

Response schema

data contains: See Save query for the exact allowlisted nested keys, types, enums, and the distinction between save-route behavior and GET /people validation.

Errors and recovery

  • 400 (invalid_request): when using the platform API key, provide a valid X-FreshTalent-Org-Id UUID.
  • 401 (unauthorized): provide a valid API key.
  • 402 (payment_required): restore entitlement.
  • 404 (not_found): the ID is not a saved query in this organization. Check List saved queries; do not assume a missing record is transient.
  • 429 or 5xx: retry with backoff. This read is safe to repeat.
This endpoint is not paginated and has no next link. The returned query can be reused on people search. It is not directly compatible with Target app_query; review Search query compatibility. Retrieving it does not execute the search or create a Target. Next: List saved queries or Save query.