# Visa Vfsglobal — 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.

> Search visa application centers, appointment locations, and visa requirements across 100+ countries through VFS Global's visa portal. Stay updated with the latest visa news, center details, and application information for your destination country.

**Category:** Travel | **Website:** [visa.vfsglobal.com/UZB/en/HRV/login](https://visa.vfsglobal.com/UZB/en/HRV/login) | **Docs:** [parse.bot/marketplace/9def8eaf-b2a0-45ec-ab0a-d18e60c50ed3/visa-vfsglobal-com-api](https://parse.bot/marketplace/9def8eaf-b2a0-45ec-ab0a-d18e60c50ed3/visa-vfsglobal-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/visa-vfsglobal/`
**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

### Get country info

Get country page configuration for a specific visa route, including search/dropdown settings and welcome text. Useful for discovering available route configurations and what features are enabled for a given mission/country combination. Returns up to 100 results per call with skip/limit offset pagination.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country_code` | string | No | Origin country ISO code (e.g. ind, pak). Case-insensitive. |
| `language` | string | No | Language code (e.g. en, fr, ar). |
| `limit` | integer | No | Max results per page (max 100). |
| `mission_code` | string | No | Mission/destination country ISO code (e.g. ita, gbr). Case-insensitive. |
| `skip` | integer | No | Number of results to skip for pagination. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/visa-vfsglobal/get-country-info \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"country_code":"<string>","language":"<string>","limit":"<integer>","mission_code":"<string>","skip":"<integer>"}'
```

### Get missions

Get all missions (destination countries) served by VFS Global, including available origin countries and supported languages for each mission. Returns the complete list of 100+ missions sorted alphabetically by name. Each mission contains an ISO code and a list of origin countries with their supported languages.

**Estimated cost:** Metered

_No parameters required._

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

### Get news

Get news and announcements from VFS Global, optionally filtered by mission and country. Returns latest updates about visa center operations, closures, and policy changes, ordered by date descending. Returns up to 100 results per call with skip/limit offset pagination.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country_code` | string | No | Origin country ISO code (e.g. IND, PAK). Case-insensitive. |
| `language` | string | No | Language code (e.g. en, fr, ar). |
| `limit` | integer | No | Max results per page (max 100). |
| `mission_code` | string | No | Mission/destination country ISO code (e.g. ITA, GBR). Case-insensitive. |
| `skip` | integer | No | Number of results to skip for pagination. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/visa-vfsglobal/get-news \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"country_code":"<string>","language":"<string>","limit":"<integer>","mission_code":"<string>","skip":"<integer>"}'
```

### Get visa centers

Get visa application center locations with coordinates, addresses, and Google Maps links. Optionally filter by mission (destination) and/or country (origin) ISO codes. Returns up to 100 results per call with skip/limit offset pagination. Each center includes geographic coordinates and address information.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country_code` | string | No | Origin country ISO code to filter by (e.g. IND, PAK, NGA). Case-insensitive. |
| `limit` | integer | No | Max results per page (max 100). |
| `mission_code` | string | No | Mission/destination country ISO code to filter by (e.g. ITA, GBR, AUS). Case-insensitive. |
| `skip` | integer | No | Number of results to skip for pagination. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/visa-vfsglobal/get-visa-centers \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"country_code":"<string>","limit":"<integer>","mission_code":"<string>","skip":"<integer>"}'
```

### Get visa types

Get visa type information for a specific mission/country route, including all available visa categories (tourist, business, study, etc.) grouped by jurisdiction/center. Each result groups visa types by center/jurisdiction with names and details.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country_code` | string | No | Origin country ISO code (e.g. ind, pak). Case-insensitive. |
| `language` | string | No | Language name (e.g. english, french, arabic). Case-insensitive. |
| `mission_code` | string | No | Mission/destination country ISO code (e.g. ita, gbr). Case-insensitive. |

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

## 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.