No authentication
Call the read-only endpoint without an account, API key, or session cookie.
Program pricing, built for AI agents.
Quote citizenship-by-investment programs for a person or family with an anonymous, read-only API that accounts for route eligibility.
No API key
OpenAPI 3.1
Live pricing
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.
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
1curl https://citizenx.com/api/agent/pricing/v1/quote \
2 --request POST \
3 --header 'Content-Type: application/json' \
4 --data '{
5 "applicants": [
6 {
7 "role": "main",
8 "age": 40,
9 "nationalityCountryCode": "US"
10 }
11 ]
12 }'200 application/json
1{
2 "provider": "CitizenX",
3 "calculatedAt": "2026-08-03T12:00:00.000Z",
4 "notice": "Prices are informational estimates based on current published rules and are not binding offers.",
5 "eligiblePrograms": [],
6 "ineligiblePrograms": []
7}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/jsonAgent resource catalog
The Agentic Resource Discovery entry for the program pricing tool.
application/ai-catalog+jsonLLM guide
A compact, human-readable index of CitizenX resources for language models.
text/plainPrices 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