LogoLogo
  • Endorsed Platform Overview
  • API Overview
  • Data Import
  • Candidate Querying
  • Support
  • Common Workflows
    • Applicant Tracking Systems
      • Bring AI-powered candidate search to your users
      • Bring lookalike search to your users
      • Bring AI-powered evaluations to your users
    • Recruitment Marketplaces
      • Screen New Marketplace Applicants for Internal Team
      • Find, Score, and Summarize Talent for Client Jobs for Internal Team
      • Talent Search APIs for Your Users
  • Reference
    • API Reference
      • Access Tokens
      • Jobs
      • Spotlights
      • Job Criteria
      • Nomination Stages
      • Candidates
      • Nominations
      • Attachments
      • Rankings
      • Summaries
      • Tags
      • Candidate Tags
      • Job Tags
      • Criterion Evaluations
      • SDK (Coming Soon)
      • Quick Start (Coming Soon)
  • Resources
    • How to Write Good Evaluation Criteria
    • HIRE Accuracy Benchmark
      • HIRE Benchmark: Setting the Standard for Candidate Evaluation AI
Powered by GitBook

© 2024 Endorsed

On this page

API Overview

Last updated 1 year ago

Here are the high-level steps to use the Platform API:

  1. We will issue client credentials to authenticate with the Endorsed API. Please treat these credentials with utmost confidentiality. Sharing them not only exposes your organization's data but also results in usage that will be billed as per your contract terms with Endorsed.

  2. Make an API call to fetch an access token using the client credentials. The access token is short-lived** (for security reasons)** and is required to call any of the Endorsed APIs. Request a new access token regularly.

  3. Use the Endorsed API to upload job candidates (this provides Job / Candidate data to Endorsed, so we can begin AI ranking and summarization):

    • Data Import

  4. If you have Endorsed Dashboard access: Uploaded Candidates will show up within minutes in the Endorsed Dashboard, where you can search and review.

  5. Ranked Candidates will be available immediately via API:

    • Candidate Querying

  6. Candidates will be summarized and available viaCandidate Querying. SLAs for processing are dependent upon your pricing plan and sales agreement.

Constructing Requests

Endorsed supports two environments which can be accessed via the following base urls:

  • Production: https://endorsed.ai

  • Staging: https://staging.endorsed.ai

Make requests to the API endpoints through the /api path. For example, a full URL for making a request to the /jobs endpoint in production would involve a full URL of https://endorsed.ai/api/v1/jobs.

Best Practices / Guidelines:

  • Set the above base urls as environment variables in your application

  • Avoid persisting real user production data into the staging environment

  • Always test in the Staging environment first before instituting your changes against the Production environment

In our section, all endpoints and examples assume the described base url above. Review this section for API definitions, request parameters, response examples, and more!

API Reference