Skip to main content

Fetch Recruiter Contracts

POST /api/v1/recruiter_contracts

Recruiter accounts may contain multiple contracts. A contract represents an organization-level entity in LinkedIn Recruiter. Regular recruiter accounts are also classified as contracts. Most recruiter endpoints require a valid contract_id to function.

Note

LinkedIn doesn't allow two concurrent sessions on a recruiter plan.

Retrieves all contracts associated with a recruiter account. Use this endpoint first to obtain the contract_id required for other recruiter operations.

Fetches the unique, organization-level Contract IDs associated with an account. Each contract represents either a team recruiter license or an individual recruiter account.

Headers​

NameTypeRequired
x-api-keystringYes
x-api-secretstringYes

Request Body​

Schema​

accountIdstringrequiredThe unique identifier of the WeLink account.

Sample Request​

{
  "accountId": "string"
}

Responses​

Webhook Events​

Schema​

statusstringStatus indicating the request completed successfully (e.g. "SUCCESS").
resultobjectThe response payload.

Sample Response​

{
  "status": "string",
  "result": {
    "contract_id": "string",
    "name": "string",
    "category": "string",
    "sso_enabled": false
  }
}
POST/api/v1/recruiter_contracts
x-api-key
x-api-secret