Agent pricing API for citizenship programs

Designed for reliable answers

One request. A decision-ready quote.

The API applies the same published route and family rules used by CitizenX pricing, then returns structured results an agent can explain.

No authentication

Call the read-only endpoint without an account, API key, or session cookie.

Eligibility-aware

See fully eligible routes and explicit exclusion reasons for ineligible programs.

Complete price quotes

Get route totals, cost summaries, processing times, and payment-stage amounts.

Quick start

Send the family. Get every matching route.

Include exactly one main applicant. Add a spouse, children, parents, or siblings as needed, up to 12 applicants in one quote.

Use ISO 3166-1 alpha-2 nationality codes.
Optionally filter by program, country, or route type.
Never send passwords, cookies, or payment details.

request.sh

curl https://citizenx.com/api/agent/pricing/v1/quote \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
    "applicants": [
      {
        "role": "main",
        "age": 40,
        "nationalityCountryCode": "US"
      }
    ]
  }'

200 application/json

{
  "provider": "CitizenX",
  "calculatedAt": "2026-08-03T12:00:00.000Z",
  "notice": "Prices are informational estimates based on current published rules and are not binding offers.",
  "eligiblePrograms": [],
  "ineligiblePrograms": []
}

Explainable by default

Built to answer the next question too.

Every response separates eligible and ineligible programs so an agent can present prices without hiding important constraints.

Eligible programs

Open routes, total costs, cost summaries, processing times, and payment stages.

Ineligible programs

The affected family member, their role, and a human-readable exclusion reason.

Freshness and context

A calculation timestamp, provider name, and the informational-pricing notice.

Agent discovery

Start with the format your agent understands.

Each discovery resource points to the same versioned pricing contract and production endpoint.

OpenAPI specification

The complete OpenAPI 3.1 contract, including schemas, examples, and errors.

application/json

Agent resource catalog

The Agentic Resource Discovery entry for the program pricing tool.

application/ai-catalog+json

LLM guide

A compact, human-readable index of CitizenX resources for language models.

text/plain

Prices are informational estimates based on current published rules and are not binding offers. The endpoint is anonymous, read-only, and rate-limited.

Read the contract

Program pricing, built for AI agents.