# Afdb — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-afdb-org-api-c180481b/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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.paywithlocus.com/api/wrapped/parse-afdb-org-api-c180481b/get_countries_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-afdb-org-api-c180481b/get_country_overview \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-afdb-org-api-c180481b/get_project_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-afdb-org-api-c180481b/list_news \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-afdb-org-api-c180481b/list_procurement_notices \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-afdb-org-api-c180481b/list_projects \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-afdb-org-api-c180481b/list_publications \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-afdb-org-api-c180481b/search_site \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>"}'
```