# Visaindex — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Check passport power rankings and visa requirements across countries, compare travel restrictions between nations, and explore golden visa programs and ETA eligibility for your destination. Find detailed information about visa policies, destination requirements, and investment-based visa options to plan international travel and relocation opportunities.

**Category:** Travel | **Website:** [visaindex.com/](https://visaindex.com/) | **Docs:** [parse.bot/marketplace/320d03c1-8dd1-4084-8dda-4640e6aa87d3/visaindex-com-api](https://parse.bot/marketplace/320d03c1-8dd1-4084-8dda-4640e6aa87d3/visaindex-com-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/visaindex/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Check visa requirement

Check the visa requirement between an origin and destination country. Country names must match the site's exact format (e.g., 'United States of America' not 'United States', 'South Korea' not 'Korea'). Returns input_not_found if the country name combination is not found.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `destination_country` | string | Yes | The destination country name using the site's exact naming (e.g., 'Russia', 'Brazil', 'France'). |
| `origin_country` | string | Yes | The origin country name using the site's exact naming (e.g., 'Singapore', 'Japan', 'United States of America', 'United Kingdom'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/visaindex/check-visa-requirement \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"destination_country":"<string>","origin_country":"<string>"}'
```

### Get country passport details

Get detailed passport information for a specific country, including rank, total visa-free destinations, and categorized country lists (visa free, visa on arrival, eTA, visa online, visa required).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country_slug` | string | Yes | The country slug as used on the site (e.g., 'singapore', 'japan', 'south-korea', 'united-states-of-america'). Available from get_passport_ranking results. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/visaindex/get-country-passport-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"country_slug":"<string>"}'
```

### Get eta info

Get general eTA (Electronic Travel Authorization) information including what ETAs are, eligibility, fees, requirements, application process, and validity periods.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/visaindex/get-eta-info \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get golden visa info

Get Golden Visa / Residency by Investment information for a specific country. Returns structured content sections about eligibility, investment options, benefits, and application process.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country_slug` | string | Yes | The country slug (e.g., 'portugal', 'greece', 'malta', 'spain', 'saudi-arabia', 'cyprus', 'uae', 'us'). Available from list_golden_visa_programs results. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/visaindex/get-golden-visa-info \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"country_slug":"<string>"}'
```

### Get passport ranking

Get the full passport ranking list from VisaIndex. Returns all countries ranked by passport power with their rank, slug, and URL. The list is ordered by rank (strongest passport first).

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/visaindex/get-passport-ranking \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get visa destination info

Get detailed visa information for a destination country. Returns structured content sections about visa types, requirements, fees, and application process.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country_slug` | string | Yes | The country slug without the '-visa' suffix (e.g., 'us', 'schengen', 'canada', 'turkey', 'uk'). Available from list_visa_destinations results. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/visaindex/get-visa-destination-info \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"country_slug":"<string>"}'
```

### List golden visa programs

List all available Golden Visa / Residency by Investment programs on VisaIndex.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/visaindex/list-golden-visa-programs \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### List visa destinations

List all available visa destination guides on VisaIndex. Returns destination names, slugs, and URLs.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/visaindex/list-visa-destinations \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.