---
title: "Search Sukuk"
method: GET
path: "/api/sukuk/search"
tags: ["sukuk"]
---

# Search Sukuk

`GET /api/sukuk/search`

## Request

- Base URL: `https://api.halalterminal.com`
- URL: `https://api.halalterminal.com/api/sukuk/search`
- Auth: API key in header `X-API-Key`

Search the sukuk registry by issuer, country, structure, currency, or
maturity window. Returns matching instruments with a total count.

## Query parameters

- `issuer` string, nullable: Filter by issuer LEI.
- `country` string, nullable: Filter by issuer country (ISO code or name).
- `structure` string, nullable: Filter by sukuk structure (e.g. ijara, murabaha, wakala).
- `documentation_basis` string, nullable: Filter by documentation basis (e.g. AAOIFI Standard 62).
- `currency` string, nullable: Filter by issue currency (ISO 4217, e.g. USD).
- `maturity_from` string, nullable: Earliest maturity date, inclusive (YYYY-MM-DD).
- `maturity_to` string, nullable: Latest maturity date, inclusive (YYYY-MM-DD).
- `limit` integer: Maximum number of instruments to return (1-500).
- `offset` integer: Number of matches to skip, for pagination.

## Response `200`

Successful Response

- object

## Other responses

- `401`: API key required or invalid
- `422`: Validation Error
- `429`: Quota exceeded

---

[API](https://skmtc.dev/halalterminal/apis/halal-terminal-api.md) · [All operations](https://skmtc.dev/halalterminal/apis/halal-terminal-api/llms.txt) · [OpenAPI document](https://skmtc.dev/halalterminal/apis/halal-terminal-api/revisions/78768b250943?raw)