# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/bawabatic/`
**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

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/credits/bawabatic/get-country-info \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/bawabatic/get-homepage \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/bawabatic/get-important-links \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/bawabatic/get-service-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/bawabatic/get-services-by-sector \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/bawabatic/get-services-by-theme \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/bawabatic/list-sectors \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/bawabatic/list-themes \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/bawabatic/search-services \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"lang":"<string>","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.