Skip to main content
GET
/
search
Search instruments
curl --request GET \
  --url https://api.halal.sh/v1/search \
  --header 'X-API-Key: <api-key>'
{
  "data": [
    {
      "symbol": "NVDA",
      "name": "NVIDIA Corporation",
      "sector": "<string>",
      "industry": "<string>",
      "current_status": "compliant",
      "last_updated": "<string>"
    }
  ],
  "meta": {
    "request_id": "req_abc123",
    "methodology": "aaoifi-ss21@2024",
    "as_of": "2026-03-08T12:00:00Z",
    "retry_after": 120,
    "total": 123,
    "query": "<string>"
  }
}

Authorizations

X-API-Key
string
header
required

Query Parameters

q
string
required

Search query (symbol or company name).

Minimum string length: 1
Example:

"nvidia"

limit
integer
default:10
Required range: x <= 100

Response

Search results (empty results array if no matches)

data
object[]
meta
object