Generated from OpenAPI 1.0.0-beta.1
API reference
Exact operations, parameters and response schemas for the developer API. For a guided first request, start with Quickstart.
Download OpenAPI JSONGET /v1/preview/opportunities
Preview live persisted Radar opportunities
Returns up to five live opportunities from Radar's persisted production data. No API key or pagination is available on this constrained preview.
| Name | Location | Contract |
|---|---|---|
| published_after | query | {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Published After"
} |
| job_family | query | {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Job Family"
} |
| job_subfamily | query | {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Job Subfamily"
} |
| job_class | query | {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Job Class"
} |
| level | query | {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Level"
} |
| engagement_model | query | {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Engagement Model"
} |
| commercial_eligibility | query | {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Commercial Eligibility"
} |
| remote | query | {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Remote"
} |
| region | query | {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Region"
} |
| rate_min | query | {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "string",
"pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"
},
{
"type": "null"
}
],
"title": "Rate Min"
} |
| pay_basis | query | {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Pay Basis"
} |
| work_structure | query | {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Work Structure"
} |
| liveness_status | query | {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Liveness Status"
} |
| cursor | query | {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Cursor"
} |
| limit | query | {
"type": "integer",
"minimum": 1,
"default": 5,
"title": "Limit"
} |
Response contracts
{
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/OpportunityListResponse"
}
}
}
},
"400": {
"description": "Invalid or unsupported preview filter.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/APIErrorResponse"
}
}
}
},
"422": {
"description": "Request validation failed.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/APIErrorResponse"
}
}
}
},
"429": {
"description": "Anonymous preview limit reached.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/APIErrorResponse"
}
}
}
}
}GET /v1/opportunities
List technology contract opportunities
Returns already-computed canonical technology-contract intelligence. Filters operate on persisted taxonomy, commercial evidence, location, freshness, and liveness fields. Use the signed `pagination.next_cursor` value unchanged with the same filters to fetch the next page. Normal access supports `limit` values up to 100, but the effective account maximum may be lower.
| Name | Location | Contract |
|---|---|---|
| published_after | query | {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Published After"
} |
| published_before | query | {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Published Before"
} |
| fresh_after | query | Earliest provider publication time, falling back to Radar first-seen time when the provider does not publish a date. The response never fabricates published_at.{
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"description": "Earliest provider publication time, falling back to Radar first-seen time when the provider does not publish a date. The response never fabricates published_at.",
"title": "Fresh After"
} |
| job_domain | query | {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Job Domain"
} |
| job_family | query | Comma-separated family IDs. A family includes every descendant role.{
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Comma-separated family IDs. A family includes every descendant role.",
"title": "Job Family"
} |
| job_subfamily | query | Comma-separated subfamily IDs that narrow any selected family.{
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Comma-separated subfamily IDs that narrow any selected family.",
"title": "Job Subfamily"
} |
| job_class | query | Comma-separated exact occupational class/role IDs.{
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Comma-separated exact occupational class/role IDs.",
"title": "Job Class"
} |
| normalized_title | query | {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Normalized Title"
} |
| level | query | Comma-separated, e.g. staff,principal.{
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Comma-separated, e.g. staff,principal.",
"title": "Level"
} |
| management_track | query | {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Management Track"
} |
| specializations | query | {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Specializations"
} |
| engagement_model | query | {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Engagement Model"
} |
| commercial_eligibility | query | {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Commercial Eligibility"
} |
| actionability | query | {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Actionability"
} |
| remote | query | {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Remote"
} |
| country | query | {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Country"
} |
| state | query | State or region alias.{
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "State or region alias.",
"title": "State"
} |
| region | query | State or region.{
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "State or region.",
"title": "Region"
} |
| city | query | {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "City"
} |
| rate_min | query | {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "string",
"pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"
},
{
"type": "null"
}
],
"title": "Rate Min"
} |
| rate_max | query | {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "string",
"pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"
},
{
"type": "null"
}
],
"title": "Rate Max"
} |
| currency | query | {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Currency"
} |
| pay_basis | query | Comma-separated normalized values: hourly, daily, monthly, annual, fixed_project, or unknown.{
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Comma-separated normalized values: hourly, daily, monthly, annual, fixed_project, or unknown.",
"title": "Pay Basis"
} |
| work_structure | query | Comma-separated normalized values: fixed_project, ongoing_contract, contract_duration, freelance_ad_hoc, or unknown.{
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Comma-separated normalized values: fixed_project, ongoing_contract, contract_duration, freelance_ad_hoc, or unknown.",
"title": "Work Structure"
} |
| source | query | {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Source"
} |
| liveness_status | query | {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Liveness Status"
} |
| first_seen_after | query | {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "First Seen After"
} |
| changed_since | query | {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Changed Since"
} |
| cursor | query | Opaque signed cursor returned as `pagination.next_cursor`. It is query-specific; pass it back unchanged and do not construct or modify it.{
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Opaque signed cursor returned as `pagination.next_cursor`. It is query-specific; pass it back unchanged and do not construct or modify it.",
"title": "Cursor"
} |
| limit | query | {
"type": "integer",
"maximum": 100,
"minimum": 1,
"default": 25,
"title": "Limit"
} |
| X-Request-ID | header | Unique caller-generated identifier for this billable request. Reuse can return `409 duplicate_request_id`.{
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Unique caller-generated identifier for this billable request. Reuse can return `409 duplicate_request_id`.",
"title": "X-Request-Id"
} |
Response contracts
{
"200": {
"description": "Canonical opportunity page with cursor, request, rate-limit, and plan usage metadata.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/OpportunityListResponse"
}
}
},
"headers": {
"X-Request-ID": {
"schema": {
"type": "string"
},
"description": "Unique request identifier supplied by the caller or generated by Radar."
},
"X-RateLimit-Limit": {
"schema": {
"type": "integer"
},
"description": "Effective authenticated request limit for the current window."
},
"X-RateLimit-Remaining": {
"schema": {
"type": "integer"
},
"description": "Requests remaining in the current rate-limit window."
},
"X-RateLimit-Reset": {
"schema": {
"type": "integer"
},
"description": "Seconds until the current rate-limit window resets."
},
"X-Radar-Balance-Millicents": {
"schema": {
"type": "integer",
"format": "int64"
},
"description": "Remaining prepaid wallet balance. 100,000 millicents equals one USD."
},
"X-Radar-Usage-Charge-Millicents": {
"schema": {
"type": "integer",
"format": "int64"
},
"description": "Prepaid PAYG wallet amount charged for this response."
},
"X-Radar-Prepaid-Opportunity-Credits": {
"schema": {
"type": "integer"
},
"description": "Additional opportunities affordable from the prepaid PAYG balance."
},
"X-Radar-Plan": {
"schema": {
"type": "string"
},
"description": "Current Radar plan for plan-billed accounts."
},
"X-Radar-Opportunity-Limit": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunity allowance for the current plan period."
},
"X-Radar-Opportunity-Used": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunities delivered in the current plan period."
},
"X-Radar-Opportunity-Remaining": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunities remaining in the current plan period."
},
"X-Radar-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New period-scoped canonical opportunity exposures in this response."
},
"X-Radar-Included-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New canonical opportunities charged to included plan allowance."
},
"X-Radar-PAYG-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New canonical opportunities charged to prepaid PAYG credit."
},
"X-RapidAPI-Billing": {
"schema": {
"type": "string",
"example": "Opportunities=17"
},
"description": "RapidAPI custom billing object emitted only for a verified RapidAPI proxy request."
},
"X-Radar-Period-End": {
"schema": {
"type": "string",
"format": "date-time"
},
"description": "Exclusive end of the current plan period."
}
}
},
"400": {
"description": "Invalid request (`invalid_filter`, `malformed_cursor`, or `page_size_exceeded`).",
"headers": {
"X-Request-ID": {
"schema": {
"type": "string"
},
"description": "Unique request identifier supplied by the caller or generated by Radar."
},
"X-RateLimit-Limit": {
"schema": {
"type": "integer"
},
"description": "Effective authenticated request limit for the current window."
},
"X-RateLimit-Remaining": {
"schema": {
"type": "integer"
},
"description": "Requests remaining in the current rate-limit window."
},
"X-RateLimit-Reset": {
"schema": {
"type": "integer"
},
"description": "Seconds until the current rate-limit window resets."
},
"X-Radar-Balance-Millicents": {
"schema": {
"type": "integer",
"format": "int64"
},
"description": "Remaining prepaid wallet balance. 100,000 millicents equals one USD."
},
"X-Radar-Usage-Charge-Millicents": {
"schema": {
"type": "integer",
"format": "int64"
},
"description": "Prepaid PAYG wallet amount charged for this response."
},
"X-Radar-Prepaid-Opportunity-Credits": {
"schema": {
"type": "integer"
},
"description": "Additional opportunities affordable from the prepaid PAYG balance."
},
"X-Radar-Plan": {
"schema": {
"type": "string"
},
"description": "Current Radar plan for plan-billed accounts."
},
"X-Radar-Opportunity-Limit": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunity allowance for the current plan period."
},
"X-Radar-Opportunity-Used": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunities delivered in the current plan period."
},
"X-Radar-Opportunity-Remaining": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunities remaining in the current plan period."
},
"X-Radar-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New period-scoped canonical opportunity exposures in this response."
},
"X-Radar-Included-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New canonical opportunities charged to included plan allowance."
},
"X-Radar-PAYG-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New canonical opportunities charged to prepaid PAYG credit."
},
"X-RapidAPI-Billing": {
"schema": {
"type": "string",
"example": "Opportunities=17"
},
"description": "RapidAPI custom billing object emitted only for a verified RapidAPI proxy request."
},
"X-Radar-Period-End": {
"schema": {
"type": "string",
"format": "date-time"
},
"description": "Exclusive end of the current plan period."
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/APIErrorResponse"
}
}
}
},
"401": {
"description": "Authentication failed (`missing_api_key`, `invalid_api_key`, or `revoked_api_key`).",
"headers": {
"X-Request-ID": {
"schema": {
"type": "string"
},
"description": "Unique request identifier supplied by the caller or generated by Radar."
},
"X-RateLimit-Limit": {
"schema": {
"type": "integer"
},
"description": "Effective authenticated request limit for the current window."
},
"X-RateLimit-Remaining": {
"schema": {
"type": "integer"
},
"description": "Requests remaining in the current rate-limit window."
},
"X-RateLimit-Reset": {
"schema": {
"type": "integer"
},
"description": "Seconds until the current rate-limit window resets."
},
"X-Radar-Balance-Millicents": {
"schema": {
"type": "integer",
"format": "int64"
},
"description": "Remaining prepaid wallet balance. 100,000 millicents equals one USD."
},
"X-Radar-Usage-Charge-Millicents": {
"schema": {
"type": "integer",
"format": "int64"
},
"description": "Prepaid PAYG wallet amount charged for this response."
},
"X-Radar-Prepaid-Opportunity-Credits": {
"schema": {
"type": "integer"
},
"description": "Additional opportunities affordable from the prepaid PAYG balance."
},
"X-Radar-Plan": {
"schema": {
"type": "string"
},
"description": "Current Radar plan for plan-billed accounts."
},
"X-Radar-Opportunity-Limit": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunity allowance for the current plan period."
},
"X-Radar-Opportunity-Used": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunities delivered in the current plan period."
},
"X-Radar-Opportunity-Remaining": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunities remaining in the current plan period."
},
"X-Radar-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New period-scoped canonical opportunity exposures in this response."
},
"X-Radar-Included-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New canonical opportunities charged to included plan allowance."
},
"X-Radar-PAYG-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New canonical opportunities charged to prepaid PAYG credit."
},
"X-RapidAPI-Billing": {
"schema": {
"type": "string",
"example": "Opportunities=17"
},
"description": "RapidAPI custom billing object emitted only for a verified RapidAPI proxy request."
},
"X-Radar-Period-End": {
"schema": {
"type": "string",
"format": "date-time"
},
"description": "Exclusive end of the current plan period."
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/APIErrorResponse"
}
}
}
},
"402": {
"description": "Included allowance and prepaid balance are insufficient (`insufficient_balance`), or a historical entitlement exhausted its legacy allowance (`opportunity_quota_exhausted`).",
"headers": {
"X-Request-ID": {
"schema": {
"type": "string"
},
"description": "Unique request identifier supplied by the caller or generated by Radar."
},
"X-RateLimit-Limit": {
"schema": {
"type": "integer"
},
"description": "Effective authenticated request limit for the current window."
},
"X-RateLimit-Remaining": {
"schema": {
"type": "integer"
},
"description": "Requests remaining in the current rate-limit window."
},
"X-RateLimit-Reset": {
"schema": {
"type": "integer"
},
"description": "Seconds until the current rate-limit window resets."
},
"X-Radar-Balance-Millicents": {
"schema": {
"type": "integer",
"format": "int64"
},
"description": "Remaining prepaid wallet balance. 100,000 millicents equals one USD."
},
"X-Radar-Usage-Charge-Millicents": {
"schema": {
"type": "integer",
"format": "int64"
},
"description": "Prepaid PAYG wallet amount charged for this response."
},
"X-Radar-Prepaid-Opportunity-Credits": {
"schema": {
"type": "integer"
},
"description": "Additional opportunities affordable from the prepaid PAYG balance."
},
"X-Radar-Plan": {
"schema": {
"type": "string"
},
"description": "Current Radar plan for plan-billed accounts."
},
"X-Radar-Opportunity-Limit": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunity allowance for the current plan period."
},
"X-Radar-Opportunity-Used": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunities delivered in the current plan period."
},
"X-Radar-Opportunity-Remaining": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunities remaining in the current plan period."
},
"X-Radar-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New period-scoped canonical opportunity exposures in this response."
},
"X-Radar-Included-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New canonical opportunities charged to included plan allowance."
},
"X-Radar-PAYG-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New canonical opportunities charged to prepaid PAYG credit."
},
"X-RapidAPI-Billing": {
"schema": {
"type": "string",
"example": "Opportunities=17"
},
"description": "RapidAPI custom billing object emitted only for a verified RapidAPI proxy request."
},
"X-Radar-Period-End": {
"schema": {
"type": "string",
"format": "date-time"
},
"description": "Exclusive end of the current plan period."
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/APIErrorResponse"
}
}
}
},
"403": {
"description": "Access is unavailable (`api_access_disabled`, `api_access_suspended`, or an inactive historical entitlement such as `plan_access_pending` or `plan_access_expired`).",
"headers": {
"X-Request-ID": {
"schema": {
"type": "string"
},
"description": "Unique request identifier supplied by the caller or generated by Radar."
},
"X-RateLimit-Limit": {
"schema": {
"type": "integer"
},
"description": "Effective authenticated request limit for the current window."
},
"X-RateLimit-Remaining": {
"schema": {
"type": "integer"
},
"description": "Requests remaining in the current rate-limit window."
},
"X-RateLimit-Reset": {
"schema": {
"type": "integer"
},
"description": "Seconds until the current rate-limit window resets."
},
"X-Radar-Balance-Millicents": {
"schema": {
"type": "integer",
"format": "int64"
},
"description": "Remaining prepaid wallet balance. 100,000 millicents equals one USD."
},
"X-Radar-Usage-Charge-Millicents": {
"schema": {
"type": "integer",
"format": "int64"
},
"description": "Prepaid PAYG wallet amount charged for this response."
},
"X-Radar-Prepaid-Opportunity-Credits": {
"schema": {
"type": "integer"
},
"description": "Additional opportunities affordable from the prepaid PAYG balance."
},
"X-Radar-Plan": {
"schema": {
"type": "string"
},
"description": "Current Radar plan for plan-billed accounts."
},
"X-Radar-Opportunity-Limit": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunity allowance for the current plan period."
},
"X-Radar-Opportunity-Used": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunities delivered in the current plan period."
},
"X-Radar-Opportunity-Remaining": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunities remaining in the current plan period."
},
"X-Radar-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New period-scoped canonical opportunity exposures in this response."
},
"X-Radar-Included-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New canonical opportunities charged to included plan allowance."
},
"X-Radar-PAYG-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New canonical opportunities charged to prepaid PAYG credit."
},
"X-RapidAPI-Billing": {
"schema": {
"type": "string",
"example": "Opportunities=17"
},
"description": "RapidAPI custom billing object emitted only for a verified RapidAPI proxy request."
},
"X-Radar-Period-End": {
"schema": {
"type": "string",
"format": "date-time"
},
"description": "Exclusive end of the current plan period."
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/APIErrorResponse"
}
}
}
},
"404": {
"description": "The requested canonical opportunity does not exist (`opportunity_not_found`).",
"headers": {
"X-Request-ID": {
"schema": {
"type": "string"
},
"description": "Unique request identifier supplied by the caller or generated by Radar."
},
"X-RateLimit-Limit": {
"schema": {
"type": "integer"
},
"description": "Effective authenticated request limit for the current window."
},
"X-RateLimit-Remaining": {
"schema": {
"type": "integer"
},
"description": "Requests remaining in the current rate-limit window."
},
"X-RateLimit-Reset": {
"schema": {
"type": "integer"
},
"description": "Seconds until the current rate-limit window resets."
},
"X-Radar-Balance-Millicents": {
"schema": {
"type": "integer",
"format": "int64"
},
"description": "Remaining prepaid wallet balance. 100,000 millicents equals one USD."
},
"X-Radar-Usage-Charge-Millicents": {
"schema": {
"type": "integer",
"format": "int64"
},
"description": "Prepaid PAYG wallet amount charged for this response."
},
"X-Radar-Prepaid-Opportunity-Credits": {
"schema": {
"type": "integer"
},
"description": "Additional opportunities affordable from the prepaid PAYG balance."
},
"X-Radar-Plan": {
"schema": {
"type": "string"
},
"description": "Current Radar plan for plan-billed accounts."
},
"X-Radar-Opportunity-Limit": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunity allowance for the current plan period."
},
"X-Radar-Opportunity-Used": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunities delivered in the current plan period."
},
"X-Radar-Opportunity-Remaining": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunities remaining in the current plan period."
},
"X-Radar-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New period-scoped canonical opportunity exposures in this response."
},
"X-Radar-Included-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New canonical opportunities charged to included plan allowance."
},
"X-Radar-PAYG-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New canonical opportunities charged to prepaid PAYG credit."
},
"X-RapidAPI-Billing": {
"schema": {
"type": "string",
"example": "Opportunities=17"
},
"description": "RapidAPI custom billing object emitted only for a verified RapidAPI proxy request."
},
"X-Radar-Period-End": {
"schema": {
"type": "string",
"format": "date-time"
},
"description": "Exclusive end of the current plan period."
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/APIErrorResponse"
}
}
}
},
"409": {
"description": "The billable `X-Request-ID` was already used (`duplicate_request_id`).",
"headers": {
"X-Request-ID": {
"schema": {
"type": "string"
},
"description": "Unique request identifier supplied by the caller or generated by Radar."
},
"X-RateLimit-Limit": {
"schema": {
"type": "integer"
},
"description": "Effective authenticated request limit for the current window."
},
"X-RateLimit-Remaining": {
"schema": {
"type": "integer"
},
"description": "Requests remaining in the current rate-limit window."
},
"X-RateLimit-Reset": {
"schema": {
"type": "integer"
},
"description": "Seconds until the current rate-limit window resets."
},
"X-Radar-Balance-Millicents": {
"schema": {
"type": "integer",
"format": "int64"
},
"description": "Remaining prepaid wallet balance. 100,000 millicents equals one USD."
},
"X-Radar-Usage-Charge-Millicents": {
"schema": {
"type": "integer",
"format": "int64"
},
"description": "Prepaid PAYG wallet amount charged for this response."
},
"X-Radar-Prepaid-Opportunity-Credits": {
"schema": {
"type": "integer"
},
"description": "Additional opportunities affordable from the prepaid PAYG balance."
},
"X-Radar-Plan": {
"schema": {
"type": "string"
},
"description": "Current Radar plan for plan-billed accounts."
},
"X-Radar-Opportunity-Limit": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunity allowance for the current plan period."
},
"X-Radar-Opportunity-Used": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunities delivered in the current plan period."
},
"X-Radar-Opportunity-Remaining": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunities remaining in the current plan period."
},
"X-Radar-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New period-scoped canonical opportunity exposures in this response."
},
"X-Radar-Included-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New canonical opportunities charged to included plan allowance."
},
"X-Radar-PAYG-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New canonical opportunities charged to prepaid PAYG credit."
},
"X-RapidAPI-Billing": {
"schema": {
"type": "string",
"example": "Opportunities=17"
},
"description": "RapidAPI custom billing object emitted only for a verified RapidAPI proxy request."
},
"X-Radar-Period-End": {
"schema": {
"type": "string",
"format": "date-time"
},
"description": "Exclusive end of the current plan period."
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/APIErrorResponse"
}
}
}
},
"422": {
"description": "Request parameter validation failed (`validation_error`).",
"headers": {
"X-Request-ID": {
"schema": {
"type": "string"
},
"description": "Unique request identifier supplied by the caller or generated by Radar."
},
"X-RateLimit-Limit": {
"schema": {
"type": "integer"
},
"description": "Effective authenticated request limit for the current window."
},
"X-RateLimit-Remaining": {
"schema": {
"type": "integer"
},
"description": "Requests remaining in the current rate-limit window."
},
"X-RateLimit-Reset": {
"schema": {
"type": "integer"
},
"description": "Seconds until the current rate-limit window resets."
},
"X-Radar-Balance-Millicents": {
"schema": {
"type": "integer",
"format": "int64"
},
"description": "Remaining prepaid wallet balance. 100,000 millicents equals one USD."
},
"X-Radar-Usage-Charge-Millicents": {
"schema": {
"type": "integer",
"format": "int64"
},
"description": "Prepaid PAYG wallet amount charged for this response."
},
"X-Radar-Prepaid-Opportunity-Credits": {
"schema": {
"type": "integer"
},
"description": "Additional opportunities affordable from the prepaid PAYG balance."
},
"X-Radar-Plan": {
"schema": {
"type": "string"
},
"description": "Current Radar plan for plan-billed accounts."
},
"X-Radar-Opportunity-Limit": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunity allowance for the current plan period."
},
"X-Radar-Opportunity-Used": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunities delivered in the current plan period."
},
"X-Radar-Opportunity-Remaining": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunities remaining in the current plan period."
},
"X-Radar-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New period-scoped canonical opportunity exposures in this response."
},
"X-Radar-Included-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New canonical opportunities charged to included plan allowance."
},
"X-Radar-PAYG-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New canonical opportunities charged to prepaid PAYG credit."
},
"X-RapidAPI-Billing": {
"schema": {
"type": "string",
"example": "Opportunities=17"
},
"description": "RapidAPI custom billing object emitted only for a verified RapidAPI proxy request."
},
"X-Radar-Period-End": {
"schema": {
"type": "string",
"format": "date-time"
},
"description": "Exclusive end of the current plan period."
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/APIErrorResponse"
}
}
}
},
"429": {
"description": "Authenticated request limit exceeded (`rate_limit_exceeded`).",
"headers": {
"X-Request-ID": {
"schema": {
"type": "string"
},
"description": "Unique request identifier supplied by the caller or generated by Radar."
},
"X-RateLimit-Limit": {
"schema": {
"type": "integer"
},
"description": "Effective authenticated request limit for the current window."
},
"X-RateLimit-Remaining": {
"schema": {
"type": "integer"
},
"description": "Requests remaining in the current rate-limit window."
},
"X-RateLimit-Reset": {
"schema": {
"type": "integer"
},
"description": "Seconds until the current rate-limit window resets."
},
"X-Radar-Balance-Millicents": {
"schema": {
"type": "integer",
"format": "int64"
},
"description": "Remaining prepaid wallet balance. 100,000 millicents equals one USD."
},
"X-Radar-Usage-Charge-Millicents": {
"schema": {
"type": "integer",
"format": "int64"
},
"description": "Prepaid PAYG wallet amount charged for this response."
},
"X-Radar-Prepaid-Opportunity-Credits": {
"schema": {
"type": "integer"
},
"description": "Additional opportunities affordable from the prepaid PAYG balance."
},
"X-Radar-Plan": {
"schema": {
"type": "string"
},
"description": "Current Radar plan for plan-billed accounts."
},
"X-Radar-Opportunity-Limit": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunity allowance for the current plan period."
},
"X-Radar-Opportunity-Used": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunities delivered in the current plan period."
},
"X-Radar-Opportunity-Remaining": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunities remaining in the current plan period."
},
"X-Radar-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New period-scoped canonical opportunity exposures in this response."
},
"X-Radar-Included-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New canonical opportunities charged to included plan allowance."
},
"X-Radar-PAYG-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New canonical opportunities charged to prepaid PAYG credit."
},
"X-RapidAPI-Billing": {
"schema": {
"type": "string",
"example": "Opportunities=17"
},
"description": "RapidAPI custom billing object emitted only for a verified RapidAPI proxy request."
},
"X-Radar-Period-End": {
"schema": {
"type": "string",
"format": "date-time"
},
"description": "Exclusive end of the current plan period."
},
"Retry-After": {
"schema": {
"type": "integer"
},
"description": "Seconds to wait before retrying."
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/APIErrorResponse"
}
}
}
},
"500": {
"description": "Unexpected server error (`internal_server_error`).",
"headers": {
"X-Request-ID": {
"schema": {
"type": "string"
},
"description": "Unique request identifier supplied by the caller or generated by Radar."
},
"X-RateLimit-Limit": {
"schema": {
"type": "integer"
},
"description": "Effective authenticated request limit for the current window."
},
"X-RateLimit-Remaining": {
"schema": {
"type": "integer"
},
"description": "Requests remaining in the current rate-limit window."
},
"X-RateLimit-Reset": {
"schema": {
"type": "integer"
},
"description": "Seconds until the current rate-limit window resets."
},
"X-Radar-Balance-Millicents": {
"schema": {
"type": "integer",
"format": "int64"
},
"description": "Remaining prepaid wallet balance. 100,000 millicents equals one USD."
},
"X-Radar-Usage-Charge-Millicents": {
"schema": {
"type": "integer",
"format": "int64"
},
"description": "Prepaid PAYG wallet amount charged for this response."
},
"X-Radar-Prepaid-Opportunity-Credits": {
"schema": {
"type": "integer"
},
"description": "Additional opportunities affordable from the prepaid PAYG balance."
},
"X-Radar-Plan": {
"schema": {
"type": "string"
},
"description": "Current Radar plan for plan-billed accounts."
},
"X-Radar-Opportunity-Limit": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunity allowance for the current plan period."
},
"X-Radar-Opportunity-Used": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunities delivered in the current plan period."
},
"X-Radar-Opportunity-Remaining": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunities remaining in the current plan period."
},
"X-Radar-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New period-scoped canonical opportunity exposures in this response."
},
"X-Radar-Included-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New canonical opportunities charged to included plan allowance."
},
"X-Radar-PAYG-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New canonical opportunities charged to prepaid PAYG credit."
},
"X-RapidAPI-Billing": {
"schema": {
"type": "string",
"example": "Opportunities=17"
},
"description": "RapidAPI custom billing object emitted only for a verified RapidAPI proxy request."
},
"X-Radar-Period-End": {
"schema": {
"type": "string",
"format": "date-time"
},
"description": "Exclusive end of the current plan period."
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/APIErrorResponse"
}
}
}
},
"503": {
"description": "Usage metering is temporarily unavailable (`metering_unavailable`).",
"headers": {
"X-Request-ID": {
"schema": {
"type": "string"
},
"description": "Unique request identifier supplied by the caller or generated by Radar."
},
"X-RateLimit-Limit": {
"schema": {
"type": "integer"
},
"description": "Effective authenticated request limit for the current window."
},
"X-RateLimit-Remaining": {
"schema": {
"type": "integer"
},
"description": "Requests remaining in the current rate-limit window."
},
"X-RateLimit-Reset": {
"schema": {
"type": "integer"
},
"description": "Seconds until the current rate-limit window resets."
},
"X-Radar-Balance-Millicents": {
"schema": {
"type": "integer",
"format": "int64"
},
"description": "Remaining prepaid wallet balance. 100,000 millicents equals one USD."
},
"X-Radar-Usage-Charge-Millicents": {
"schema": {
"type": "integer",
"format": "int64"
},
"description": "Prepaid PAYG wallet amount charged for this response."
},
"X-Radar-Prepaid-Opportunity-Credits": {
"schema": {
"type": "integer"
},
"description": "Additional opportunities affordable from the prepaid PAYG balance."
},
"X-Radar-Plan": {
"schema": {
"type": "string"
},
"description": "Current Radar plan for plan-billed accounts."
},
"X-Radar-Opportunity-Limit": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunity allowance for the current plan period."
},
"X-Radar-Opportunity-Used": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunities delivered in the current plan period."
},
"X-Radar-Opportunity-Remaining": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunities remaining in the current plan period."
},
"X-Radar-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New period-scoped canonical opportunity exposures in this response."
},
"X-Radar-Included-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New canonical opportunities charged to included plan allowance."
},
"X-Radar-PAYG-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New canonical opportunities charged to prepaid PAYG credit."
},
"X-RapidAPI-Billing": {
"schema": {
"type": "string",
"example": "Opportunities=17"
},
"description": "RapidAPI custom billing object emitted only for a verified RapidAPI proxy request."
},
"X-Radar-Period-End": {
"schema": {
"type": "string",
"format": "date-time"
},
"description": "Exclusive end of the current plan period."
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/APIErrorResponse"
}
}
}
}
}GET /v1/opportunities/count
Count matching opportunities without consuming opportunity quota
| Name | Location | Contract |
|---|---|---|
| published_after | query | {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Published After"
} |
| published_before | query | {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Published Before"
} |
| fresh_after | query | {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Fresh After"
} |
| job_domain | query | {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Job Domain"
} |
| job_family | query | {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Job Family"
} |
| job_subfamily | query | {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Job Subfamily"
} |
| job_class | query | {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Job Class"
} |
| normalized_title | query | {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Normalized Title"
} |
| level | query | {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Level"
} |
| management_track | query | {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Management Track"
} |
| specializations | query | {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Specializations"
} |
| engagement_model | query | {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Engagement Model"
} |
| commercial_eligibility | query | {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Commercial Eligibility"
} |
| actionability | query | {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Actionability"
} |
| remote | query | {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Remote"
} |
| country | query | {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Country"
} |
| state | query | {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "State"
} |
| region | query | {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Region"
} |
| city | query | {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "City"
} |
| rate_min | query | {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "string",
"pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"
},
{
"type": "null"
}
],
"title": "Rate Min"
} |
| rate_max | query | {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "string",
"pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"
},
{
"type": "null"
}
],
"title": "Rate Max"
} |
| currency | query | {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Currency"
} |
| pay_basis | query | {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Pay Basis"
} |
| work_structure | query | {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Work Structure"
} |
| source | query | {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Source"
} |
| liveness_status | query | {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Liveness Status"
} |
| first_seen_after | query | {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "First Seen After"
} |
| changed_since | query | {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Changed Since"
} |
Response contracts
{
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/OpportunityCountResponse"
}
}
}
},
"400": {
"description": "Invalid request (`invalid_filter`, `malformed_cursor`, or `page_size_exceeded`).",
"headers": {
"X-Request-ID": {
"schema": {
"type": "string"
},
"description": "Unique request identifier supplied by the caller or generated by Radar."
},
"X-RateLimit-Limit": {
"schema": {
"type": "integer"
},
"description": "Effective authenticated request limit for the current window."
},
"X-RateLimit-Remaining": {
"schema": {
"type": "integer"
},
"description": "Requests remaining in the current rate-limit window."
},
"X-RateLimit-Reset": {
"schema": {
"type": "integer"
},
"description": "Seconds until the current rate-limit window resets."
},
"X-Radar-Balance-Millicents": {
"schema": {
"type": "integer",
"format": "int64"
},
"description": "Remaining prepaid wallet balance. 100,000 millicents equals one USD."
},
"X-Radar-Usage-Charge-Millicents": {
"schema": {
"type": "integer",
"format": "int64"
},
"description": "Prepaid PAYG wallet amount charged for this response."
},
"X-Radar-Prepaid-Opportunity-Credits": {
"schema": {
"type": "integer"
},
"description": "Additional opportunities affordable from the prepaid PAYG balance."
},
"X-Radar-Plan": {
"schema": {
"type": "string"
},
"description": "Current Radar plan for plan-billed accounts."
},
"X-Radar-Opportunity-Limit": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunity allowance for the current plan period."
},
"X-Radar-Opportunity-Used": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunities delivered in the current plan period."
},
"X-Radar-Opportunity-Remaining": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunities remaining in the current plan period."
},
"X-Radar-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New period-scoped canonical opportunity exposures in this response."
},
"X-Radar-Included-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New canonical opportunities charged to included plan allowance."
},
"X-Radar-PAYG-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New canonical opportunities charged to prepaid PAYG credit."
},
"X-RapidAPI-Billing": {
"schema": {
"type": "string",
"example": "Opportunities=17"
},
"description": "RapidAPI custom billing object emitted only for a verified RapidAPI proxy request."
},
"X-Radar-Period-End": {
"schema": {
"type": "string",
"format": "date-time"
},
"description": "Exclusive end of the current plan period."
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/APIErrorResponse"
}
}
}
},
"401": {
"description": "Authentication failed (`missing_api_key`, `invalid_api_key`, or `revoked_api_key`).",
"headers": {
"X-Request-ID": {
"schema": {
"type": "string"
},
"description": "Unique request identifier supplied by the caller or generated by Radar."
},
"X-RateLimit-Limit": {
"schema": {
"type": "integer"
},
"description": "Effective authenticated request limit for the current window."
},
"X-RateLimit-Remaining": {
"schema": {
"type": "integer"
},
"description": "Requests remaining in the current rate-limit window."
},
"X-RateLimit-Reset": {
"schema": {
"type": "integer"
},
"description": "Seconds until the current rate-limit window resets."
},
"X-Radar-Balance-Millicents": {
"schema": {
"type": "integer",
"format": "int64"
},
"description": "Remaining prepaid wallet balance. 100,000 millicents equals one USD."
},
"X-Radar-Usage-Charge-Millicents": {
"schema": {
"type": "integer",
"format": "int64"
},
"description": "Prepaid PAYG wallet amount charged for this response."
},
"X-Radar-Prepaid-Opportunity-Credits": {
"schema": {
"type": "integer"
},
"description": "Additional opportunities affordable from the prepaid PAYG balance."
},
"X-Radar-Plan": {
"schema": {
"type": "string"
},
"description": "Current Radar plan for plan-billed accounts."
},
"X-Radar-Opportunity-Limit": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunity allowance for the current plan period."
},
"X-Radar-Opportunity-Used": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunities delivered in the current plan period."
},
"X-Radar-Opportunity-Remaining": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunities remaining in the current plan period."
},
"X-Radar-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New period-scoped canonical opportunity exposures in this response."
},
"X-Radar-Included-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New canonical opportunities charged to included plan allowance."
},
"X-Radar-PAYG-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New canonical opportunities charged to prepaid PAYG credit."
},
"X-RapidAPI-Billing": {
"schema": {
"type": "string",
"example": "Opportunities=17"
},
"description": "RapidAPI custom billing object emitted only for a verified RapidAPI proxy request."
},
"X-Radar-Period-End": {
"schema": {
"type": "string",
"format": "date-time"
},
"description": "Exclusive end of the current plan period."
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/APIErrorResponse"
}
}
}
},
"402": {
"description": "Included allowance and prepaid balance are insufficient (`insufficient_balance`), or a historical entitlement exhausted its legacy allowance (`opportunity_quota_exhausted`).",
"headers": {
"X-Request-ID": {
"schema": {
"type": "string"
},
"description": "Unique request identifier supplied by the caller or generated by Radar."
},
"X-RateLimit-Limit": {
"schema": {
"type": "integer"
},
"description": "Effective authenticated request limit for the current window."
},
"X-RateLimit-Remaining": {
"schema": {
"type": "integer"
},
"description": "Requests remaining in the current rate-limit window."
},
"X-RateLimit-Reset": {
"schema": {
"type": "integer"
},
"description": "Seconds until the current rate-limit window resets."
},
"X-Radar-Balance-Millicents": {
"schema": {
"type": "integer",
"format": "int64"
},
"description": "Remaining prepaid wallet balance. 100,000 millicents equals one USD."
},
"X-Radar-Usage-Charge-Millicents": {
"schema": {
"type": "integer",
"format": "int64"
},
"description": "Prepaid PAYG wallet amount charged for this response."
},
"X-Radar-Prepaid-Opportunity-Credits": {
"schema": {
"type": "integer"
},
"description": "Additional opportunities affordable from the prepaid PAYG balance."
},
"X-Radar-Plan": {
"schema": {
"type": "string"
},
"description": "Current Radar plan for plan-billed accounts."
},
"X-Radar-Opportunity-Limit": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunity allowance for the current plan period."
},
"X-Radar-Opportunity-Used": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunities delivered in the current plan period."
},
"X-Radar-Opportunity-Remaining": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunities remaining in the current plan period."
},
"X-Radar-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New period-scoped canonical opportunity exposures in this response."
},
"X-Radar-Included-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New canonical opportunities charged to included plan allowance."
},
"X-Radar-PAYG-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New canonical opportunities charged to prepaid PAYG credit."
},
"X-RapidAPI-Billing": {
"schema": {
"type": "string",
"example": "Opportunities=17"
},
"description": "RapidAPI custom billing object emitted only for a verified RapidAPI proxy request."
},
"X-Radar-Period-End": {
"schema": {
"type": "string",
"format": "date-time"
},
"description": "Exclusive end of the current plan period."
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/APIErrorResponse"
}
}
}
},
"403": {
"description": "Access is unavailable (`api_access_disabled`, `api_access_suspended`, or an inactive historical entitlement such as `plan_access_pending` or `plan_access_expired`).",
"headers": {
"X-Request-ID": {
"schema": {
"type": "string"
},
"description": "Unique request identifier supplied by the caller or generated by Radar."
},
"X-RateLimit-Limit": {
"schema": {
"type": "integer"
},
"description": "Effective authenticated request limit for the current window."
},
"X-RateLimit-Remaining": {
"schema": {
"type": "integer"
},
"description": "Requests remaining in the current rate-limit window."
},
"X-RateLimit-Reset": {
"schema": {
"type": "integer"
},
"description": "Seconds until the current rate-limit window resets."
},
"X-Radar-Balance-Millicents": {
"schema": {
"type": "integer",
"format": "int64"
},
"description": "Remaining prepaid wallet balance. 100,000 millicents equals one USD."
},
"X-Radar-Usage-Charge-Millicents": {
"schema": {
"type": "integer",
"format": "int64"
},
"description": "Prepaid PAYG wallet amount charged for this response."
},
"X-Radar-Prepaid-Opportunity-Credits": {
"schema": {
"type": "integer"
},
"description": "Additional opportunities affordable from the prepaid PAYG balance."
},
"X-Radar-Plan": {
"schema": {
"type": "string"
},
"description": "Current Radar plan for plan-billed accounts."
},
"X-Radar-Opportunity-Limit": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunity allowance for the current plan period."
},
"X-Radar-Opportunity-Used": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunities delivered in the current plan period."
},
"X-Radar-Opportunity-Remaining": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunities remaining in the current plan period."
},
"X-Radar-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New period-scoped canonical opportunity exposures in this response."
},
"X-Radar-Included-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New canonical opportunities charged to included plan allowance."
},
"X-Radar-PAYG-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New canonical opportunities charged to prepaid PAYG credit."
},
"X-RapidAPI-Billing": {
"schema": {
"type": "string",
"example": "Opportunities=17"
},
"description": "RapidAPI custom billing object emitted only for a verified RapidAPI proxy request."
},
"X-Radar-Period-End": {
"schema": {
"type": "string",
"format": "date-time"
},
"description": "Exclusive end of the current plan period."
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/APIErrorResponse"
}
}
}
},
"404": {
"description": "The requested canonical opportunity does not exist (`opportunity_not_found`).",
"headers": {
"X-Request-ID": {
"schema": {
"type": "string"
},
"description": "Unique request identifier supplied by the caller or generated by Radar."
},
"X-RateLimit-Limit": {
"schema": {
"type": "integer"
},
"description": "Effective authenticated request limit for the current window."
},
"X-RateLimit-Remaining": {
"schema": {
"type": "integer"
},
"description": "Requests remaining in the current rate-limit window."
},
"X-RateLimit-Reset": {
"schema": {
"type": "integer"
},
"description": "Seconds until the current rate-limit window resets."
},
"X-Radar-Balance-Millicents": {
"schema": {
"type": "integer",
"format": "int64"
},
"description": "Remaining prepaid wallet balance. 100,000 millicents equals one USD."
},
"X-Radar-Usage-Charge-Millicents": {
"schema": {
"type": "integer",
"format": "int64"
},
"description": "Prepaid PAYG wallet amount charged for this response."
},
"X-Radar-Prepaid-Opportunity-Credits": {
"schema": {
"type": "integer"
},
"description": "Additional opportunities affordable from the prepaid PAYG balance."
},
"X-Radar-Plan": {
"schema": {
"type": "string"
},
"description": "Current Radar plan for plan-billed accounts."
},
"X-Radar-Opportunity-Limit": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunity allowance for the current plan period."
},
"X-Radar-Opportunity-Used": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunities delivered in the current plan period."
},
"X-Radar-Opportunity-Remaining": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunities remaining in the current plan period."
},
"X-Radar-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New period-scoped canonical opportunity exposures in this response."
},
"X-Radar-Included-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New canonical opportunities charged to included plan allowance."
},
"X-Radar-PAYG-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New canonical opportunities charged to prepaid PAYG credit."
},
"X-RapidAPI-Billing": {
"schema": {
"type": "string",
"example": "Opportunities=17"
},
"description": "RapidAPI custom billing object emitted only for a verified RapidAPI proxy request."
},
"X-Radar-Period-End": {
"schema": {
"type": "string",
"format": "date-time"
},
"description": "Exclusive end of the current plan period."
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/APIErrorResponse"
}
}
}
},
"409": {
"description": "The billable `X-Request-ID` was already used (`duplicate_request_id`).",
"headers": {
"X-Request-ID": {
"schema": {
"type": "string"
},
"description": "Unique request identifier supplied by the caller or generated by Radar."
},
"X-RateLimit-Limit": {
"schema": {
"type": "integer"
},
"description": "Effective authenticated request limit for the current window."
},
"X-RateLimit-Remaining": {
"schema": {
"type": "integer"
},
"description": "Requests remaining in the current rate-limit window."
},
"X-RateLimit-Reset": {
"schema": {
"type": "integer"
},
"description": "Seconds until the current rate-limit window resets."
},
"X-Radar-Balance-Millicents": {
"schema": {
"type": "integer",
"format": "int64"
},
"description": "Remaining prepaid wallet balance. 100,000 millicents equals one USD."
},
"X-Radar-Usage-Charge-Millicents": {
"schema": {
"type": "integer",
"format": "int64"
},
"description": "Prepaid PAYG wallet amount charged for this response."
},
"X-Radar-Prepaid-Opportunity-Credits": {
"schema": {
"type": "integer"
},
"description": "Additional opportunities affordable from the prepaid PAYG balance."
},
"X-Radar-Plan": {
"schema": {
"type": "string"
},
"description": "Current Radar plan for plan-billed accounts."
},
"X-Radar-Opportunity-Limit": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunity allowance for the current plan period."
},
"X-Radar-Opportunity-Used": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunities delivered in the current plan period."
},
"X-Radar-Opportunity-Remaining": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunities remaining in the current plan period."
},
"X-Radar-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New period-scoped canonical opportunity exposures in this response."
},
"X-Radar-Included-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New canonical opportunities charged to included plan allowance."
},
"X-Radar-PAYG-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New canonical opportunities charged to prepaid PAYG credit."
},
"X-RapidAPI-Billing": {
"schema": {
"type": "string",
"example": "Opportunities=17"
},
"description": "RapidAPI custom billing object emitted only for a verified RapidAPI proxy request."
},
"X-Radar-Period-End": {
"schema": {
"type": "string",
"format": "date-time"
},
"description": "Exclusive end of the current plan period."
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/APIErrorResponse"
}
}
}
},
"422": {
"description": "Request parameter validation failed (`validation_error`).",
"headers": {
"X-Request-ID": {
"schema": {
"type": "string"
},
"description": "Unique request identifier supplied by the caller or generated by Radar."
},
"X-RateLimit-Limit": {
"schema": {
"type": "integer"
},
"description": "Effective authenticated request limit for the current window."
},
"X-RateLimit-Remaining": {
"schema": {
"type": "integer"
},
"description": "Requests remaining in the current rate-limit window."
},
"X-RateLimit-Reset": {
"schema": {
"type": "integer"
},
"description": "Seconds until the current rate-limit window resets."
},
"X-Radar-Balance-Millicents": {
"schema": {
"type": "integer",
"format": "int64"
},
"description": "Remaining prepaid wallet balance. 100,000 millicents equals one USD."
},
"X-Radar-Usage-Charge-Millicents": {
"schema": {
"type": "integer",
"format": "int64"
},
"description": "Prepaid PAYG wallet amount charged for this response."
},
"X-Radar-Prepaid-Opportunity-Credits": {
"schema": {
"type": "integer"
},
"description": "Additional opportunities affordable from the prepaid PAYG balance."
},
"X-Radar-Plan": {
"schema": {
"type": "string"
},
"description": "Current Radar plan for plan-billed accounts."
},
"X-Radar-Opportunity-Limit": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunity allowance for the current plan period."
},
"X-Radar-Opportunity-Used": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunities delivered in the current plan period."
},
"X-Radar-Opportunity-Remaining": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunities remaining in the current plan period."
},
"X-Radar-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New period-scoped canonical opportunity exposures in this response."
},
"X-Radar-Included-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New canonical opportunities charged to included plan allowance."
},
"X-Radar-PAYG-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New canonical opportunities charged to prepaid PAYG credit."
},
"X-RapidAPI-Billing": {
"schema": {
"type": "string",
"example": "Opportunities=17"
},
"description": "RapidAPI custom billing object emitted only for a verified RapidAPI proxy request."
},
"X-Radar-Period-End": {
"schema": {
"type": "string",
"format": "date-time"
},
"description": "Exclusive end of the current plan period."
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/APIErrorResponse"
}
}
}
},
"429": {
"description": "Authenticated request limit exceeded (`rate_limit_exceeded`).",
"headers": {
"X-Request-ID": {
"schema": {
"type": "string"
},
"description": "Unique request identifier supplied by the caller or generated by Radar."
},
"X-RateLimit-Limit": {
"schema": {
"type": "integer"
},
"description": "Effective authenticated request limit for the current window."
},
"X-RateLimit-Remaining": {
"schema": {
"type": "integer"
},
"description": "Requests remaining in the current rate-limit window."
},
"X-RateLimit-Reset": {
"schema": {
"type": "integer"
},
"description": "Seconds until the current rate-limit window resets."
},
"X-Radar-Balance-Millicents": {
"schema": {
"type": "integer",
"format": "int64"
},
"description": "Remaining prepaid wallet balance. 100,000 millicents equals one USD."
},
"X-Radar-Usage-Charge-Millicents": {
"schema": {
"type": "integer",
"format": "int64"
},
"description": "Prepaid PAYG wallet amount charged for this response."
},
"X-Radar-Prepaid-Opportunity-Credits": {
"schema": {
"type": "integer"
},
"description": "Additional opportunities affordable from the prepaid PAYG balance."
},
"X-Radar-Plan": {
"schema": {
"type": "string"
},
"description": "Current Radar plan for plan-billed accounts."
},
"X-Radar-Opportunity-Limit": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunity allowance for the current plan period."
},
"X-Radar-Opportunity-Used": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunities delivered in the current plan period."
},
"X-Radar-Opportunity-Remaining": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunities remaining in the current plan period."
},
"X-Radar-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New period-scoped canonical opportunity exposures in this response."
},
"X-Radar-Included-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New canonical opportunities charged to included plan allowance."
},
"X-Radar-PAYG-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New canonical opportunities charged to prepaid PAYG credit."
},
"X-RapidAPI-Billing": {
"schema": {
"type": "string",
"example": "Opportunities=17"
},
"description": "RapidAPI custom billing object emitted only for a verified RapidAPI proxy request."
},
"X-Radar-Period-End": {
"schema": {
"type": "string",
"format": "date-time"
},
"description": "Exclusive end of the current plan period."
},
"Retry-After": {
"schema": {
"type": "integer"
},
"description": "Seconds to wait before retrying."
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/APIErrorResponse"
}
}
}
},
"500": {
"description": "Unexpected server error (`internal_server_error`).",
"headers": {
"X-Request-ID": {
"schema": {
"type": "string"
},
"description": "Unique request identifier supplied by the caller or generated by Radar."
},
"X-RateLimit-Limit": {
"schema": {
"type": "integer"
},
"description": "Effective authenticated request limit for the current window."
},
"X-RateLimit-Remaining": {
"schema": {
"type": "integer"
},
"description": "Requests remaining in the current rate-limit window."
},
"X-RateLimit-Reset": {
"schema": {
"type": "integer"
},
"description": "Seconds until the current rate-limit window resets."
},
"X-Radar-Balance-Millicents": {
"schema": {
"type": "integer",
"format": "int64"
},
"description": "Remaining prepaid wallet balance. 100,000 millicents equals one USD."
},
"X-Radar-Usage-Charge-Millicents": {
"schema": {
"type": "integer",
"format": "int64"
},
"description": "Prepaid PAYG wallet amount charged for this response."
},
"X-Radar-Prepaid-Opportunity-Credits": {
"schema": {
"type": "integer"
},
"description": "Additional opportunities affordable from the prepaid PAYG balance."
},
"X-Radar-Plan": {
"schema": {
"type": "string"
},
"description": "Current Radar plan for plan-billed accounts."
},
"X-Radar-Opportunity-Limit": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunity allowance for the current plan period."
},
"X-Radar-Opportunity-Used": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunities delivered in the current plan period."
},
"X-Radar-Opportunity-Remaining": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunities remaining in the current plan period."
},
"X-Radar-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New period-scoped canonical opportunity exposures in this response."
},
"X-Radar-Included-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New canonical opportunities charged to included plan allowance."
},
"X-Radar-PAYG-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New canonical opportunities charged to prepaid PAYG credit."
},
"X-RapidAPI-Billing": {
"schema": {
"type": "string",
"example": "Opportunities=17"
},
"description": "RapidAPI custom billing object emitted only for a verified RapidAPI proxy request."
},
"X-Radar-Period-End": {
"schema": {
"type": "string",
"format": "date-time"
},
"description": "Exclusive end of the current plan period."
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/APIErrorResponse"
}
}
}
},
"503": {
"description": "Usage metering is temporarily unavailable (`metering_unavailable`).",
"headers": {
"X-Request-ID": {
"schema": {
"type": "string"
},
"description": "Unique request identifier supplied by the caller or generated by Radar."
},
"X-RateLimit-Limit": {
"schema": {
"type": "integer"
},
"description": "Effective authenticated request limit for the current window."
},
"X-RateLimit-Remaining": {
"schema": {
"type": "integer"
},
"description": "Requests remaining in the current rate-limit window."
},
"X-RateLimit-Reset": {
"schema": {
"type": "integer"
},
"description": "Seconds until the current rate-limit window resets."
},
"X-Radar-Balance-Millicents": {
"schema": {
"type": "integer",
"format": "int64"
},
"description": "Remaining prepaid wallet balance. 100,000 millicents equals one USD."
},
"X-Radar-Usage-Charge-Millicents": {
"schema": {
"type": "integer",
"format": "int64"
},
"description": "Prepaid PAYG wallet amount charged for this response."
},
"X-Radar-Prepaid-Opportunity-Credits": {
"schema": {
"type": "integer"
},
"description": "Additional opportunities affordable from the prepaid PAYG balance."
},
"X-Radar-Plan": {
"schema": {
"type": "string"
},
"description": "Current Radar plan for plan-billed accounts."
},
"X-Radar-Opportunity-Limit": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunity allowance for the current plan period."
},
"X-Radar-Opportunity-Used": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunities delivered in the current plan period."
},
"X-Radar-Opportunity-Remaining": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunities remaining in the current plan period."
},
"X-Radar-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New period-scoped canonical opportunity exposures in this response."
},
"X-Radar-Included-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New canonical opportunities charged to included plan allowance."
},
"X-Radar-PAYG-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New canonical opportunities charged to prepaid PAYG credit."
},
"X-RapidAPI-Billing": {
"schema": {
"type": "string",
"example": "Opportunities=17"
},
"description": "RapidAPI custom billing object emitted only for a verified RapidAPI proxy request."
},
"X-Radar-Period-End": {
"schema": {
"type": "string",
"format": "date-time"
},
"description": "Exclusive end of the current plan period."
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/APIErrorResponse"
}
}
}
}
}GET /v1/opportunities/{opportunity_id}
Get one canonical opportunity
Returns one already-persisted canonical opportunity. Send a unique `X-Request-ID` for the billable authenticated request.
| Name | Location | Contract |
|---|---|---|
| opportunity_id * | path | Stable Radar opportunity ID.{
"type": "string",
"format": "uuid",
"description": "Stable Radar opportunity ID.",
"title": "Opportunity Id"
} |
| X-Request-ID | header | Unique caller-generated identifier for this billable request. Reuse can return `409 duplicate_request_id`.{
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Unique caller-generated identifier for this billable request. Reuse can return `409 duplicate_request_id`.",
"title": "X-Request-Id"
} |
Response contracts
{
"200": {
"description": "Canonical opportunity page with cursor, request, rate-limit, and plan usage metadata.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/OpportunityDetailResponse"
}
}
},
"headers": {
"X-Request-ID": {
"schema": {
"type": "string"
},
"description": "Unique request identifier supplied by the caller or generated by Radar."
},
"X-RateLimit-Limit": {
"schema": {
"type": "integer"
},
"description": "Effective authenticated request limit for the current window."
},
"X-RateLimit-Remaining": {
"schema": {
"type": "integer"
},
"description": "Requests remaining in the current rate-limit window."
},
"X-RateLimit-Reset": {
"schema": {
"type": "integer"
},
"description": "Seconds until the current rate-limit window resets."
},
"X-Radar-Balance-Millicents": {
"schema": {
"type": "integer",
"format": "int64"
},
"description": "Remaining prepaid wallet balance. 100,000 millicents equals one USD."
},
"X-Radar-Usage-Charge-Millicents": {
"schema": {
"type": "integer",
"format": "int64"
},
"description": "Prepaid PAYG wallet amount charged for this response."
},
"X-Radar-Prepaid-Opportunity-Credits": {
"schema": {
"type": "integer"
},
"description": "Additional opportunities affordable from the prepaid PAYG balance."
},
"X-Radar-Plan": {
"schema": {
"type": "string"
},
"description": "Current Radar plan for plan-billed accounts."
},
"X-Radar-Opportunity-Limit": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunity allowance for the current plan period."
},
"X-Radar-Opportunity-Used": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunities delivered in the current plan period."
},
"X-Radar-Opportunity-Remaining": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunities remaining in the current plan period."
},
"X-Radar-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New period-scoped canonical opportunity exposures in this response."
},
"X-Radar-Included-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New canonical opportunities charged to included plan allowance."
},
"X-Radar-PAYG-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New canonical opportunities charged to prepaid PAYG credit."
},
"X-RapidAPI-Billing": {
"schema": {
"type": "string",
"example": "Opportunities=17"
},
"description": "RapidAPI custom billing object emitted only for a verified RapidAPI proxy request."
},
"X-Radar-Period-End": {
"schema": {
"type": "string",
"format": "date-time"
},
"description": "Exclusive end of the current plan period."
}
}
},
"400": {
"description": "Invalid request (`invalid_filter`, `malformed_cursor`, or `page_size_exceeded`).",
"headers": {
"X-Request-ID": {
"schema": {
"type": "string"
},
"description": "Unique request identifier supplied by the caller or generated by Radar."
},
"X-RateLimit-Limit": {
"schema": {
"type": "integer"
},
"description": "Effective authenticated request limit for the current window."
},
"X-RateLimit-Remaining": {
"schema": {
"type": "integer"
},
"description": "Requests remaining in the current rate-limit window."
},
"X-RateLimit-Reset": {
"schema": {
"type": "integer"
},
"description": "Seconds until the current rate-limit window resets."
},
"X-Radar-Balance-Millicents": {
"schema": {
"type": "integer",
"format": "int64"
},
"description": "Remaining prepaid wallet balance. 100,000 millicents equals one USD."
},
"X-Radar-Usage-Charge-Millicents": {
"schema": {
"type": "integer",
"format": "int64"
},
"description": "Prepaid PAYG wallet amount charged for this response."
},
"X-Radar-Prepaid-Opportunity-Credits": {
"schema": {
"type": "integer"
},
"description": "Additional opportunities affordable from the prepaid PAYG balance."
},
"X-Radar-Plan": {
"schema": {
"type": "string"
},
"description": "Current Radar plan for plan-billed accounts."
},
"X-Radar-Opportunity-Limit": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunity allowance for the current plan period."
},
"X-Radar-Opportunity-Used": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunities delivered in the current plan period."
},
"X-Radar-Opportunity-Remaining": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunities remaining in the current plan period."
},
"X-Radar-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New period-scoped canonical opportunity exposures in this response."
},
"X-Radar-Included-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New canonical opportunities charged to included plan allowance."
},
"X-Radar-PAYG-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New canonical opportunities charged to prepaid PAYG credit."
},
"X-RapidAPI-Billing": {
"schema": {
"type": "string",
"example": "Opportunities=17"
},
"description": "RapidAPI custom billing object emitted only for a verified RapidAPI proxy request."
},
"X-Radar-Period-End": {
"schema": {
"type": "string",
"format": "date-time"
},
"description": "Exclusive end of the current plan period."
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/APIErrorResponse"
}
}
}
},
"401": {
"description": "Authentication failed (`missing_api_key`, `invalid_api_key`, or `revoked_api_key`).",
"headers": {
"X-Request-ID": {
"schema": {
"type": "string"
},
"description": "Unique request identifier supplied by the caller or generated by Radar."
},
"X-RateLimit-Limit": {
"schema": {
"type": "integer"
},
"description": "Effective authenticated request limit for the current window."
},
"X-RateLimit-Remaining": {
"schema": {
"type": "integer"
},
"description": "Requests remaining in the current rate-limit window."
},
"X-RateLimit-Reset": {
"schema": {
"type": "integer"
},
"description": "Seconds until the current rate-limit window resets."
},
"X-Radar-Balance-Millicents": {
"schema": {
"type": "integer",
"format": "int64"
},
"description": "Remaining prepaid wallet balance. 100,000 millicents equals one USD."
},
"X-Radar-Usage-Charge-Millicents": {
"schema": {
"type": "integer",
"format": "int64"
},
"description": "Prepaid PAYG wallet amount charged for this response."
},
"X-Radar-Prepaid-Opportunity-Credits": {
"schema": {
"type": "integer"
},
"description": "Additional opportunities affordable from the prepaid PAYG balance."
},
"X-Radar-Plan": {
"schema": {
"type": "string"
},
"description": "Current Radar plan for plan-billed accounts."
},
"X-Radar-Opportunity-Limit": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunity allowance for the current plan period."
},
"X-Radar-Opportunity-Used": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunities delivered in the current plan period."
},
"X-Radar-Opportunity-Remaining": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunities remaining in the current plan period."
},
"X-Radar-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New period-scoped canonical opportunity exposures in this response."
},
"X-Radar-Included-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New canonical opportunities charged to included plan allowance."
},
"X-Radar-PAYG-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New canonical opportunities charged to prepaid PAYG credit."
},
"X-RapidAPI-Billing": {
"schema": {
"type": "string",
"example": "Opportunities=17"
},
"description": "RapidAPI custom billing object emitted only for a verified RapidAPI proxy request."
},
"X-Radar-Period-End": {
"schema": {
"type": "string",
"format": "date-time"
},
"description": "Exclusive end of the current plan period."
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/APIErrorResponse"
}
}
}
},
"402": {
"description": "Included allowance and prepaid balance are insufficient (`insufficient_balance`), or a historical entitlement exhausted its legacy allowance (`opportunity_quota_exhausted`).",
"headers": {
"X-Request-ID": {
"schema": {
"type": "string"
},
"description": "Unique request identifier supplied by the caller or generated by Radar."
},
"X-RateLimit-Limit": {
"schema": {
"type": "integer"
},
"description": "Effective authenticated request limit for the current window."
},
"X-RateLimit-Remaining": {
"schema": {
"type": "integer"
},
"description": "Requests remaining in the current rate-limit window."
},
"X-RateLimit-Reset": {
"schema": {
"type": "integer"
},
"description": "Seconds until the current rate-limit window resets."
},
"X-Radar-Balance-Millicents": {
"schema": {
"type": "integer",
"format": "int64"
},
"description": "Remaining prepaid wallet balance. 100,000 millicents equals one USD."
},
"X-Radar-Usage-Charge-Millicents": {
"schema": {
"type": "integer",
"format": "int64"
},
"description": "Prepaid PAYG wallet amount charged for this response."
},
"X-Radar-Prepaid-Opportunity-Credits": {
"schema": {
"type": "integer"
},
"description": "Additional opportunities affordable from the prepaid PAYG balance."
},
"X-Radar-Plan": {
"schema": {
"type": "string"
},
"description": "Current Radar plan for plan-billed accounts."
},
"X-Radar-Opportunity-Limit": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunity allowance for the current plan period."
},
"X-Radar-Opportunity-Used": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunities delivered in the current plan period."
},
"X-Radar-Opportunity-Remaining": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunities remaining in the current plan period."
},
"X-Radar-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New period-scoped canonical opportunity exposures in this response."
},
"X-Radar-Included-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New canonical opportunities charged to included plan allowance."
},
"X-Radar-PAYG-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New canonical opportunities charged to prepaid PAYG credit."
},
"X-RapidAPI-Billing": {
"schema": {
"type": "string",
"example": "Opportunities=17"
},
"description": "RapidAPI custom billing object emitted only for a verified RapidAPI proxy request."
},
"X-Radar-Period-End": {
"schema": {
"type": "string",
"format": "date-time"
},
"description": "Exclusive end of the current plan period."
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/APIErrorResponse"
}
}
}
},
"403": {
"description": "Access is unavailable (`api_access_disabled`, `api_access_suspended`, or an inactive historical entitlement such as `plan_access_pending` or `plan_access_expired`).",
"headers": {
"X-Request-ID": {
"schema": {
"type": "string"
},
"description": "Unique request identifier supplied by the caller or generated by Radar."
},
"X-RateLimit-Limit": {
"schema": {
"type": "integer"
},
"description": "Effective authenticated request limit for the current window."
},
"X-RateLimit-Remaining": {
"schema": {
"type": "integer"
},
"description": "Requests remaining in the current rate-limit window."
},
"X-RateLimit-Reset": {
"schema": {
"type": "integer"
},
"description": "Seconds until the current rate-limit window resets."
},
"X-Radar-Balance-Millicents": {
"schema": {
"type": "integer",
"format": "int64"
},
"description": "Remaining prepaid wallet balance. 100,000 millicents equals one USD."
},
"X-Radar-Usage-Charge-Millicents": {
"schema": {
"type": "integer",
"format": "int64"
},
"description": "Prepaid PAYG wallet amount charged for this response."
},
"X-Radar-Prepaid-Opportunity-Credits": {
"schema": {
"type": "integer"
},
"description": "Additional opportunities affordable from the prepaid PAYG balance."
},
"X-Radar-Plan": {
"schema": {
"type": "string"
},
"description": "Current Radar plan for plan-billed accounts."
},
"X-Radar-Opportunity-Limit": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunity allowance for the current plan period."
},
"X-Radar-Opportunity-Used": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunities delivered in the current plan period."
},
"X-Radar-Opportunity-Remaining": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunities remaining in the current plan period."
},
"X-Radar-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New period-scoped canonical opportunity exposures in this response."
},
"X-Radar-Included-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New canonical opportunities charged to included plan allowance."
},
"X-Radar-PAYG-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New canonical opportunities charged to prepaid PAYG credit."
},
"X-RapidAPI-Billing": {
"schema": {
"type": "string",
"example": "Opportunities=17"
},
"description": "RapidAPI custom billing object emitted only for a verified RapidAPI proxy request."
},
"X-Radar-Period-End": {
"schema": {
"type": "string",
"format": "date-time"
},
"description": "Exclusive end of the current plan period."
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/APIErrorResponse"
}
}
}
},
"404": {
"description": "The requested canonical opportunity does not exist (`opportunity_not_found`).",
"headers": {
"X-Request-ID": {
"schema": {
"type": "string"
},
"description": "Unique request identifier supplied by the caller or generated by Radar."
},
"X-RateLimit-Limit": {
"schema": {
"type": "integer"
},
"description": "Effective authenticated request limit for the current window."
},
"X-RateLimit-Remaining": {
"schema": {
"type": "integer"
},
"description": "Requests remaining in the current rate-limit window."
},
"X-RateLimit-Reset": {
"schema": {
"type": "integer"
},
"description": "Seconds until the current rate-limit window resets."
},
"X-Radar-Balance-Millicents": {
"schema": {
"type": "integer",
"format": "int64"
},
"description": "Remaining prepaid wallet balance. 100,000 millicents equals one USD."
},
"X-Radar-Usage-Charge-Millicents": {
"schema": {
"type": "integer",
"format": "int64"
},
"description": "Prepaid PAYG wallet amount charged for this response."
},
"X-Radar-Prepaid-Opportunity-Credits": {
"schema": {
"type": "integer"
},
"description": "Additional opportunities affordable from the prepaid PAYG balance."
},
"X-Radar-Plan": {
"schema": {
"type": "string"
},
"description": "Current Radar plan for plan-billed accounts."
},
"X-Radar-Opportunity-Limit": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunity allowance for the current plan period."
},
"X-Radar-Opportunity-Used": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunities delivered in the current plan period."
},
"X-Radar-Opportunity-Remaining": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunities remaining in the current plan period."
},
"X-Radar-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New period-scoped canonical opportunity exposures in this response."
},
"X-Radar-Included-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New canonical opportunities charged to included plan allowance."
},
"X-Radar-PAYG-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New canonical opportunities charged to prepaid PAYG credit."
},
"X-RapidAPI-Billing": {
"schema": {
"type": "string",
"example": "Opportunities=17"
},
"description": "RapidAPI custom billing object emitted only for a verified RapidAPI proxy request."
},
"X-Radar-Period-End": {
"schema": {
"type": "string",
"format": "date-time"
},
"description": "Exclusive end of the current plan period."
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/APIErrorResponse"
}
}
}
},
"409": {
"description": "The billable `X-Request-ID` was already used (`duplicate_request_id`).",
"headers": {
"X-Request-ID": {
"schema": {
"type": "string"
},
"description": "Unique request identifier supplied by the caller or generated by Radar."
},
"X-RateLimit-Limit": {
"schema": {
"type": "integer"
},
"description": "Effective authenticated request limit for the current window."
},
"X-RateLimit-Remaining": {
"schema": {
"type": "integer"
},
"description": "Requests remaining in the current rate-limit window."
},
"X-RateLimit-Reset": {
"schema": {
"type": "integer"
},
"description": "Seconds until the current rate-limit window resets."
},
"X-Radar-Balance-Millicents": {
"schema": {
"type": "integer",
"format": "int64"
},
"description": "Remaining prepaid wallet balance. 100,000 millicents equals one USD."
},
"X-Radar-Usage-Charge-Millicents": {
"schema": {
"type": "integer",
"format": "int64"
},
"description": "Prepaid PAYG wallet amount charged for this response."
},
"X-Radar-Prepaid-Opportunity-Credits": {
"schema": {
"type": "integer"
},
"description": "Additional opportunities affordable from the prepaid PAYG balance."
},
"X-Radar-Plan": {
"schema": {
"type": "string"
},
"description": "Current Radar plan for plan-billed accounts."
},
"X-Radar-Opportunity-Limit": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunity allowance for the current plan period."
},
"X-Radar-Opportunity-Used": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunities delivered in the current plan period."
},
"X-Radar-Opportunity-Remaining": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunities remaining in the current plan period."
},
"X-Radar-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New period-scoped canonical opportunity exposures in this response."
},
"X-Radar-Included-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New canonical opportunities charged to included plan allowance."
},
"X-Radar-PAYG-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New canonical opportunities charged to prepaid PAYG credit."
},
"X-RapidAPI-Billing": {
"schema": {
"type": "string",
"example": "Opportunities=17"
},
"description": "RapidAPI custom billing object emitted only for a verified RapidAPI proxy request."
},
"X-Radar-Period-End": {
"schema": {
"type": "string",
"format": "date-time"
},
"description": "Exclusive end of the current plan period."
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/APIErrorResponse"
}
}
}
},
"422": {
"description": "Request parameter validation failed (`validation_error`).",
"headers": {
"X-Request-ID": {
"schema": {
"type": "string"
},
"description": "Unique request identifier supplied by the caller or generated by Radar."
},
"X-RateLimit-Limit": {
"schema": {
"type": "integer"
},
"description": "Effective authenticated request limit for the current window."
},
"X-RateLimit-Remaining": {
"schema": {
"type": "integer"
},
"description": "Requests remaining in the current rate-limit window."
},
"X-RateLimit-Reset": {
"schema": {
"type": "integer"
},
"description": "Seconds until the current rate-limit window resets."
},
"X-Radar-Balance-Millicents": {
"schema": {
"type": "integer",
"format": "int64"
},
"description": "Remaining prepaid wallet balance. 100,000 millicents equals one USD."
},
"X-Radar-Usage-Charge-Millicents": {
"schema": {
"type": "integer",
"format": "int64"
},
"description": "Prepaid PAYG wallet amount charged for this response."
},
"X-Radar-Prepaid-Opportunity-Credits": {
"schema": {
"type": "integer"
},
"description": "Additional opportunities affordable from the prepaid PAYG balance."
},
"X-Radar-Plan": {
"schema": {
"type": "string"
},
"description": "Current Radar plan for plan-billed accounts."
},
"X-Radar-Opportunity-Limit": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunity allowance for the current plan period."
},
"X-Radar-Opportunity-Used": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunities delivered in the current plan period."
},
"X-Radar-Opportunity-Remaining": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunities remaining in the current plan period."
},
"X-Radar-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New period-scoped canonical opportunity exposures in this response."
},
"X-Radar-Included-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New canonical opportunities charged to included plan allowance."
},
"X-Radar-PAYG-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New canonical opportunities charged to prepaid PAYG credit."
},
"X-RapidAPI-Billing": {
"schema": {
"type": "string",
"example": "Opportunities=17"
},
"description": "RapidAPI custom billing object emitted only for a verified RapidAPI proxy request."
},
"X-Radar-Period-End": {
"schema": {
"type": "string",
"format": "date-time"
},
"description": "Exclusive end of the current plan period."
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/APIErrorResponse"
}
}
}
},
"429": {
"description": "Authenticated request limit exceeded (`rate_limit_exceeded`).",
"headers": {
"X-Request-ID": {
"schema": {
"type": "string"
},
"description": "Unique request identifier supplied by the caller or generated by Radar."
},
"X-RateLimit-Limit": {
"schema": {
"type": "integer"
},
"description": "Effective authenticated request limit for the current window."
},
"X-RateLimit-Remaining": {
"schema": {
"type": "integer"
},
"description": "Requests remaining in the current rate-limit window."
},
"X-RateLimit-Reset": {
"schema": {
"type": "integer"
},
"description": "Seconds until the current rate-limit window resets."
},
"X-Radar-Balance-Millicents": {
"schema": {
"type": "integer",
"format": "int64"
},
"description": "Remaining prepaid wallet balance. 100,000 millicents equals one USD."
},
"X-Radar-Usage-Charge-Millicents": {
"schema": {
"type": "integer",
"format": "int64"
},
"description": "Prepaid PAYG wallet amount charged for this response."
},
"X-Radar-Prepaid-Opportunity-Credits": {
"schema": {
"type": "integer"
},
"description": "Additional opportunities affordable from the prepaid PAYG balance."
},
"X-Radar-Plan": {
"schema": {
"type": "string"
},
"description": "Current Radar plan for plan-billed accounts."
},
"X-Radar-Opportunity-Limit": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunity allowance for the current plan period."
},
"X-Radar-Opportunity-Used": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunities delivered in the current plan period."
},
"X-Radar-Opportunity-Remaining": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunities remaining in the current plan period."
},
"X-Radar-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New period-scoped canonical opportunity exposures in this response."
},
"X-Radar-Included-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New canonical opportunities charged to included plan allowance."
},
"X-Radar-PAYG-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New canonical opportunities charged to prepaid PAYG credit."
},
"X-RapidAPI-Billing": {
"schema": {
"type": "string",
"example": "Opportunities=17"
},
"description": "RapidAPI custom billing object emitted only for a verified RapidAPI proxy request."
},
"X-Radar-Period-End": {
"schema": {
"type": "string",
"format": "date-time"
},
"description": "Exclusive end of the current plan period."
},
"Retry-After": {
"schema": {
"type": "integer"
},
"description": "Seconds to wait before retrying."
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/APIErrorResponse"
}
}
}
},
"500": {
"description": "Unexpected server error (`internal_server_error`).",
"headers": {
"X-Request-ID": {
"schema": {
"type": "string"
},
"description": "Unique request identifier supplied by the caller or generated by Radar."
},
"X-RateLimit-Limit": {
"schema": {
"type": "integer"
},
"description": "Effective authenticated request limit for the current window."
},
"X-RateLimit-Remaining": {
"schema": {
"type": "integer"
},
"description": "Requests remaining in the current rate-limit window."
},
"X-RateLimit-Reset": {
"schema": {
"type": "integer"
},
"description": "Seconds until the current rate-limit window resets."
},
"X-Radar-Balance-Millicents": {
"schema": {
"type": "integer",
"format": "int64"
},
"description": "Remaining prepaid wallet balance. 100,000 millicents equals one USD."
},
"X-Radar-Usage-Charge-Millicents": {
"schema": {
"type": "integer",
"format": "int64"
},
"description": "Prepaid PAYG wallet amount charged for this response."
},
"X-Radar-Prepaid-Opportunity-Credits": {
"schema": {
"type": "integer"
},
"description": "Additional opportunities affordable from the prepaid PAYG balance."
},
"X-Radar-Plan": {
"schema": {
"type": "string"
},
"description": "Current Radar plan for plan-billed accounts."
},
"X-Radar-Opportunity-Limit": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunity allowance for the current plan period."
},
"X-Radar-Opportunity-Used": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunities delivered in the current plan period."
},
"X-Radar-Opportunity-Remaining": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunities remaining in the current plan period."
},
"X-Radar-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New period-scoped canonical opportunity exposures in this response."
},
"X-Radar-Included-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New canonical opportunities charged to included plan allowance."
},
"X-Radar-PAYG-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New canonical opportunities charged to prepaid PAYG credit."
},
"X-RapidAPI-Billing": {
"schema": {
"type": "string",
"example": "Opportunities=17"
},
"description": "RapidAPI custom billing object emitted only for a verified RapidAPI proxy request."
},
"X-Radar-Period-End": {
"schema": {
"type": "string",
"format": "date-time"
},
"description": "Exclusive end of the current plan period."
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/APIErrorResponse"
}
}
}
},
"503": {
"description": "Usage metering is temporarily unavailable (`metering_unavailable`).",
"headers": {
"X-Request-ID": {
"schema": {
"type": "string"
},
"description": "Unique request identifier supplied by the caller or generated by Radar."
},
"X-RateLimit-Limit": {
"schema": {
"type": "integer"
},
"description": "Effective authenticated request limit for the current window."
},
"X-RateLimit-Remaining": {
"schema": {
"type": "integer"
},
"description": "Requests remaining in the current rate-limit window."
},
"X-RateLimit-Reset": {
"schema": {
"type": "integer"
},
"description": "Seconds until the current rate-limit window resets."
},
"X-Radar-Balance-Millicents": {
"schema": {
"type": "integer",
"format": "int64"
},
"description": "Remaining prepaid wallet balance. 100,000 millicents equals one USD."
},
"X-Radar-Usage-Charge-Millicents": {
"schema": {
"type": "integer",
"format": "int64"
},
"description": "Prepaid PAYG wallet amount charged for this response."
},
"X-Radar-Prepaid-Opportunity-Credits": {
"schema": {
"type": "integer"
},
"description": "Additional opportunities affordable from the prepaid PAYG balance."
},
"X-Radar-Plan": {
"schema": {
"type": "string"
},
"description": "Current Radar plan for plan-billed accounts."
},
"X-Radar-Opportunity-Limit": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunity allowance for the current plan period."
},
"X-Radar-Opportunity-Used": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunities delivered in the current plan period."
},
"X-Radar-Opportunity-Remaining": {
"schema": {
"type": "integer"
},
"description": "Unique canonical opportunities remaining in the current plan period."
},
"X-Radar-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New period-scoped canonical opportunity exposures in this response."
},
"X-Radar-Included-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New canonical opportunities charged to included plan allowance."
},
"X-Radar-PAYG-New-Opportunity-Count": {
"schema": {
"type": "integer"
},
"description": "New canonical opportunities charged to prepaid PAYG credit."
},
"X-RapidAPI-Billing": {
"schema": {
"type": "string",
"example": "Opportunities=17"
},
"description": "RapidAPI custom billing object emitted only for a verified RapidAPI proxy request."
},
"X-Radar-Period-End": {
"schema": {
"type": "string",
"format": "date-time"
},
"description": "Exclusive end of the current plan period."
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/APIErrorResponse"
}
}
}
}
}GET /v1/taxonomy/occupations
Get the occupational taxonomy
Returns the authoritative versioned hierarchy used by Radar opportunity filters. Each node has a stable ID, level, label, and parent relationship.
Response contracts
{
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PublicTaxonomyResponse"
}
}
}
}
}Schemas
OpportunityListResponse
{
"properties": {
"data": {
"items": {
"$ref": "#/components/schemas/PublicOpportunity"
},
"type": "array",
"title": "Data"
},
"pagination": {
"$ref": "#/components/schemas/Pagination"
},
"meta": {
"$ref": "#/components/schemas/ResponseMeta"
}
},
"type": "object",
"required": [
"data",
"pagination",
"meta"
],
"title": "OpportunityListResponse"
}PublicOpportunity
{
"properties": {
"id": {
"type": "string",
"format": "uuid",
"title": "Id"
},
"title": {
"type": "string",
"title": "Title"
},
"normalized_title": {
"type": "string",
"title": "Normalized Title"
},
"employer": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Employer"
},
"intermediary": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Intermediary"
},
"organizations": {
"items": {
"$ref": "#/components/schemas/PublicOrganization"
},
"type": "array",
"title": "Organizations"
},
"canonical_url": {
"anyOf": [
{
"type": "string",
"maxLength": 2083,
"minLength": 1,
"format": "uri"
},
{
"type": "null"
}
],
"title": "Canonical Url",
"description": "Canonical source/listing URL for the opportunity manifestation."
},
"application_url": {
"anyOf": [
{
"type": "string",
"maxLength": 2083,
"minLength": 1,
"format": "uri"
},
{
"type": "null"
}
],
"title": "Application Url",
"description": "Best known safe application destination; falls back to the raw source-provided application URL when destination resolution is unavailable."
},
"sources": {
"items": {
"$ref": "#/components/schemas/PublicSource"
},
"type": "array",
"title": "Sources"
},
"published_at": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Published At"
},
"published_precision": {
"type": "string",
"title": "Published Precision"
},
"first_seen": {
"type": "string",
"format": "date-time",
"title": "First Seen"
},
"changed_at": {
"type": "string",
"format": "date-time",
"title": "Changed At"
},
"last_verified_live_at": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Last Verified Live At"
},
"liveness_status": {
"type": "string",
"title": "Liveness Status"
},
"technology_classification": {
"type": "string",
"title": "Technology Classification"
},
"job_domain": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Job Domain"
},
"job_family": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Job Family"
},
"job_subfamily": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Job Subfamily"
},
"job_class": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Job Class"
},
"level": {
"type": "string",
"title": "Level"
},
"management_track": {
"type": "string",
"title": "Management Track"
},
"specializations": {
"items": {
"type": "string"
},
"type": "array",
"title": "Specializations"
},
"engagement_models": {
"items": {
"type": "string"
},
"type": "array",
"title": "Engagement Models"
},
"commercial_eligibility": {
"type": "string",
"title": "Commercial Eligibility"
},
"actionability": {
"type": "string",
"title": "Actionability"
},
"location": {
"$ref": "#/components/schemas/PublicLocation"
},
"rate": {
"anyOf": [
{
"$ref": "#/components/schemas/PublicRate"
},
{
"type": "null"
}
]
},
"is_low_pay": {
"type": "boolean",
"title": "Is Low Pay",
"default": false
},
"pay_basis": {
"type": "string",
"title": "Pay Basis",
"default": "unknown"
},
"work_structure": {
"type": "string",
"title": "Work Structure",
"default": "unknown"
},
"duration": {
"anyOf": [
{
"$ref": "#/components/schemas/PublicContractDuration"
},
{
"type": "null"
}
]
},
"evidence": {
"items": {
"$ref": "#/components/schemas/PublicEvidence"
},
"type": "array",
"title": "Evidence"
},
"taxonomy_version": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Taxonomy Version"
},
"intelligence_version": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Intelligence Version"
}
},
"type": "object",
"required": [
"id",
"title",
"normalized_title",
"employer",
"intermediary",
"canonical_url",
"application_url",
"published_at",
"published_precision",
"first_seen",
"changed_at",
"last_verified_live_at",
"liveness_status",
"technology_classification",
"job_domain",
"job_family",
"job_subfamily",
"job_class",
"level",
"management_track",
"commercial_eligibility",
"actionability",
"location",
"rate",
"taxonomy_version",
"intelligence_version"
],
"title": "PublicOpportunity"
}PublicOrganization
{
"properties": {
"name": {
"type": "string",
"title": "Name"
},
"roles": {
"items": {
"type": "string"
},
"type": "array",
"title": "Roles"
}
},
"type": "object",
"required": [
"name"
],
"title": "PublicOrganization"
}PublicSource
{
"properties": {
"name": {
"type": "string",
"title": "Name"
},
"slug": {
"type": "string",
"title": "Slug"
},
"listing_url": {
"type": "string",
"maxLength": 2083,
"minLength": 1,
"format": "uri",
"title": "Listing Url"
},
"canonicality": {
"type": "string",
"title": "Canonicality"
},
"first_seen": {
"type": "string",
"format": "date-time",
"title": "First Seen"
},
"last_observed_at": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Last Observed At"
}
},
"type": "object",
"required": [
"name",
"slug",
"listing_url",
"canonicality",
"first_seen",
"last_observed_at"
],
"title": "PublicSource"
}PublicLocation
{
"properties": {
"text": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Text"
},
"remote": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Remote"
},
"country": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Country"
},
"region": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Region"
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "City"
}
},
"type": "object",
"title": "PublicLocation"
}PublicRate
{
"properties": {
"minimum": {
"anyOf": [
{
"type": "string",
"pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"
},
{
"type": "null"
}
],
"title": "Minimum",
"description": "Normalized lower compensation bound, without display symbols."
},
"maximum": {
"anyOf": [
{
"type": "string",
"pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"
},
{
"type": "null"
}
],
"title": "Maximum",
"description": "Normalized upper compensation bound, without display symbols."
},
"currency": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Currency",
"description": "Explicit normalized ISO-like source currency when known."
},
"unit": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Unit",
"description": "Normalized pay period: hour, day, week, month, year, or project."
},
"source_text": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Source Text",
"description": "Original source compensation evidence; structured fields are authoritative."
},
"qualitative": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Qualitative",
"description": "Reserved for backward compatibility. Unknown or qualitative source compensation is not exposed as customer-facing compensation."
}
},
"type": "object",
"title": "PublicRate"
}PublicContractDuration
{
"properties": {
"value": {
"type": "string",
"pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$",
"title": "Value",
"description": "Positive duration value stated by the source."
},
"unit": {
"type": "string",
"title": "Unit",
"description": "Normalized duration unit: day, week, month, or year."
},
"source_text": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Source Text",
"description": "Exact source fragment supporting the normalized duration."
}
},
"type": "object",
"required": [
"value",
"unit"
],
"title": "PublicContractDuration"
}PublicEvidence
{
"properties": {
"kind": {
"type": "string",
"title": "Kind"
},
"label": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Label"
},
"excerpt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Excerpt"
}
},
"type": "object",
"required": [
"kind"
],
"title": "PublicEvidence"
}Pagination
{
"properties": {
"limit": {
"type": "integer",
"title": "Limit"
},
"returned": {
"type": "integer",
"title": "Returned"
},
"has_more": {
"type": "boolean",
"title": "Has More"
},
"next_cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Next Cursor"
},
"total": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Total"
}
},
"type": "object",
"required": [
"limit",
"returned",
"has_more"
],
"title": "Pagination"
}ResponseMeta
{
"properties": {
"request_id": {
"type": "string",
"title": "Request Id"
},
"applied_filters": {
"additionalProperties": true,
"type": "object",
"title": "Applied Filters"
}
},
"type": "object",
"required": [
"request_id"
],
"title": "ResponseMeta"
}APIErrorResponse
{
"properties": {
"error": {
"$ref": "#/components/schemas/ErrorBody"
}
},
"type": "object",
"required": [
"error"
],
"title": "APIErrorResponse"
}ErrorBody
{
"properties": {
"code": {
"type": "string",
"title": "Code"
},
"message": {
"type": "string",
"title": "Message"
},
"request_id": {
"type": "string",
"title": "Request Id"
},
"details": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array",
"title": "Details"
}
},
"type": "object",
"required": [
"code",
"message",
"request_id"
],
"title": "ErrorBody"
}OpportunityCountResponse
{
"properties": {
"count": {
"type": "integer",
"title": "Count"
},
"meta": {
"$ref": "#/components/schemas/ResponseMeta"
}
},
"type": "object",
"required": [
"count",
"meta"
],
"title": "OpportunityCountResponse"
}OpportunityDetailResponse
{
"properties": {
"data": {
"$ref": "#/components/schemas/PublicOpportunity"
},
"meta": {
"$ref": "#/components/schemas/ResponseMeta"
}
},
"type": "object",
"required": [
"data",
"meta"
],
"title": "OpportunityDetailResponse"
}PublicTaxonomyResponse
{
"properties": {
"version": {
"type": "string",
"title": "Version"
},
"root": {
"type": "string",
"title": "Root"
},
"nodes": {
"items": {
"$ref": "#/components/schemas/PublicTaxonomyNode"
},
"type": "array",
"title": "Nodes"
}
},
"type": "object",
"required": [
"version",
"root",
"nodes"
],
"title": "PublicTaxonomyResponse"
}PublicTaxonomyNode
{
"properties": {
"id": {
"type": "string",
"title": "Id"
},
"parent_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Parent Id"
},
"level": {
"type": "string",
"title": "Level"
},
"label": {
"type": "string",
"title": "Label"
}
},
"type": "object",
"required": [
"id",
"parent_id",
"level",
"label"
],
"title": "PublicTaxonomyNode"
}