API Reference
cURL
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>" } }
Search for stocks by symbol or company name. Returns 200 with empty results array when no instruments match the query.
200
results
Search query (symbol or company name).
1
"nvidia"
x <= 100
Search results (empty results array if no matches)
Show child attributes