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

> Access comprehensive information about African development initiatives, including country profiles, infrastructure projects, procurement opportunities, publications, and news from the African Development Bank. Search and retrieve detailed data on ongoing projects, tenders, and resources to track development activities across Africa.

**Category:** Government & Public Data | **Website:** [afdb.org/](https://afdb.org/) | **Docs:** [parse.bot/marketplace/c180481b-e1a9-4f3b-b780-f3e72fb2333c/afdb-org-api](https://parse.bot/marketplace/c180481b-e1a9-4f3b-b780-f3e72fb2333c/afdb-org-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/afdb/`
**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 countries list

Returns all African Development Bank member countries organized by region. Each country includes name, slug, region_slug, and URL. Use country slugs as input to get_country_overview for detailed profiles.

**Estimated cost:** Metered

_No parameters required._

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

### Get country overview

Returns detailed profile for a specific AfDB member country including economic outlook narrative, key facts, bank intervention strategy, and portfolio information. Requires country_slug (from get_countries_list); region_slug defaults to west-africa but should match the country's actual region for reliable results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country_slug` | string | Yes | Country slug as returned by get_countries_list (e.g. 'nigeria', 'kenya', 'morocco'). |
| `region_slug` | string | No | Region slug from get_countries_list (e.g. 'west-africa', 'east-africa', 'north-africa', 'central-africa', 'southern-africa', 'non-regional-member-countries'). |

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

### Get project detail

Get full details for a specific project by its AfDB identifier. Returns comprehensive project information including financial data, dates, sector classifications, and status. Accepts either the short AfDB identifier (e.g. 'P-Z1-DD0-015') or the full IATI identifier with 46002- prefix.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `project_id` | string | Yes | AfDB project identifier (e.g. 'P-CV-AAF-003'). Can also use the full IATI identifier with 46002- prefix (e.g. '46002-P-CV-AAF-003'). |

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

### List news

List AfDB news articles. Returns paginated news items with title, URL, publication date, and summary text.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number (0-based). |

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

### List procurement notices

List project-related procurement notices from the AfDB website. Supports keyword search filtering and pagination. Returns notices with title, URL, publication date, and associated country.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number (0-based). |
| `query` | string | No | Search query to filter notices by title keyword (e.g. 'Kenya', 'energy', 'water'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/afdb/list-procurement-notices \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>"}'
```

### List projects

List AfDB projects from the MapAfrica database. Returns project records with financial and status information, plus filterable arrays of valid country codes, sectors, themes, status values, regions, years, and ADF cycles. Supports pagination via limit/offset and filtering by ISO country code.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country_code` | string | No | ISO 2-letter country code to filter by (e.g. 'NG', 'KE', 'ET'). Available codes are returned in the filterable.countries array. |
| `limit` | integer | No | Number of results per page. |
| `offset` | integer | No | Offset for pagination. |

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

### List publications

List AfDB publications. Supports keyword search filtering and pagination. Returns publications with title, URL, and date.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number (0-based). |
| `query` | string | No | Search query to filter publications by title keyword (e.g. 'infrastructure', 'climate change'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/afdb/list-publications \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>"}'
```

### Search site

Global full-text search across the AfDB website. Returns search results with titles, URLs, content snippets, dates, and content type classifications. Paginates via page parameter.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number (0-based). |
| `query` | string | Yes | Search query keywords. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/afdb/search-site \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<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.