# Bawabatic — 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 Algerian public services by browsing themes and sectors, searching for specific procedures, and viewing detailed service requirements from the official government portal. Find service details, important government links, and country information to navigate administrative processes more easily.

**Category:** Government & Public Data | **Website:** [bawabatic.dz/](https://bawabatic.dz/) | **Docs:** [parse.bot/marketplace/c951a385-47da-4368-b8d2-05e0a53d9754/bawabatic-dz-api](https://parse.bot/marketplace/c951a385-47da-4368-b8d2-05e0a53d9754/bawabatic-dz-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-bawabatic-dz-api-c951a385/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_country_info

Retrieve general country information about Algeria as presented on the portal.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `lang` | string | No | Language (ar/fr/en) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bawabatic-dz-api-c951a385/get_country_info \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lang":"<string>"}'
```

### get_homepage

Fetch the main homepage of the Government Portal of Public Services, returning the portal description and basic metadata. Supports lang parameter (ar/fr/en).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `lang` | string | No | Language (ar/fr/en) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bawabatic-dz-api-c951a385/get_homepage \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lang":"<string>"}'
```

### get_important_links

Retrieve the list of important external government links featured on the portal.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `lang` | string | No | Language (ar/fr/en) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bawabatic-dz-api-c951a385/get_important_links \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lang":"<string>"}'
```

### get_service_detail

Retrieve full details of a specific public service or procedure by its ID.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `lang` | string | No | Language (ar/fr/en) |
| `service_id` | string | Yes | Service ID |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bawabatic-dz-api-c951a385/get_service_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lang":"<string>","service_id":"<string>"}'
```

### get_services_by_sector

Retrieve all public services listed under a specific ministry/sector.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `lang` | string | No | Language (ar/fr/en) |
| `sector_id` | string | Yes | Sector ID |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bawabatic-dz-api-c951a385/get_services_by_sector \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lang":"<string>","sector_id":"<string>"}'
```

### get_services_by_theme

Retrieve all public services listed under a specific theme.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `lang` | string | No | Language (ar/fr/en) |
| `theme_id` | string | Yes | Theme ID |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bawabatic-dz-api-c951a385/get_services_by_theme \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lang":"<string>","theme_id":"<string>"}'
```

### list_sectors

Retrieve all ministries/sectors listed on the portal.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `lang` | string | No | Language (ar/fr/en) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bawabatic-dz-api-c951a385/list_sectors \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lang":"<string>"}'
```

### list_themes

Retrieve all available service themes/categories. Returns a list of theme objects including theme ID, name, and service count.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `lang` | string | No | Language (ar/fr/en) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bawabatic-dz-api-c951a385/list_themes \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lang":"<string>"}'
```

### search_services

Search for public services by keyword across all themes and sectors.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `lang` | string | No | Language (ar/fr/en) |
| `query` | string | Yes | Search keyword |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bawabatic-dz-api-c951a385/search_services \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lang":"<string>","query":"<string>"}'
```