# Bawabatic — 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 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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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>"}'
```