REST API, webhooks, embeddable widgets, and SSO. Wire AiHIRE briefs, experts, and milestone payments into your own product.
Send a brief through our API and get back structured scope and a ranked list of experts in seconds.
Drop our service-card or expert-profile widget into your CMS, blog, or partner portal — fully styled or themeable.
Subscribe to order events to trigger your own ops — invoicing, accounting, internal Slack pings.
Run AiHIRE as the backend for an industry-vertical marketplace. White-label commerce, our trust.
Single sign-on (SAML, OIDC) and user provisioning for AiHIRE Business workspaces.
Submit briefs in batch from your procurement system. Get bulk responses with normalized scopes.
curl -X POST https://api.aihire.ae/v1/briefs \
-H "Authorization: Bearer $AIHIRE_KEY" \
-H "Content-Type: application/json" \
-d '{
"raw": "We need a bilingual WhatsApp agent that captures real-estate leads, qualifies them, and books viewings on Bitrix.",
"category": "ai-services",
"budget_usd_max": 5000,
"deadline_days": 30
}'{
"brief": {
"id": "brf_2032",
"title": "Bilingual WhatsApp lead-qualification agent",
"category": "ai-services",
"outcome": "Capture, qualify, and book viewings end-to-end",
"deliverables": [
"Discovery + system prompt + eval set",
"MVP agent on staging with WhatsApp + Bitrix",
"Production launch with monitoring"
],
"budget_usd_range": [3500, 5000],
"timeline_days": [21, 30]
},
"recommended_experts": [
{ "id": "exp_001", "username": "leila-hashemi", "match_score": 0.94 },
{ "id": "exp_003", "username": "fatima-al-zaabi", "match_score": 0.91 },
{ "id": "exp_006", "username": "ahmed-mansour", "match_score": 0.78 }
]
}JSON over HTTPS, idempotency keys on POST, cursor pagination, ISO-8601 timestamps.
| Method | Path | Description |
|---|---|---|
| POST | /v1/briefs | Create a structured brief from raw text. Returns brief id + recommended experts. |
| GET | /v1/services | Search services by category, skills, budget, delivery. Paginated, filterable. |
| GET | /v1/experts/:username | Read an expert profile, services, and verification badges. |
| POST | /v1/orders | Place an order on a service or custom offer; funds escrow. |
| POST | /v1/orders/:id/milestones/:m/approve | Approve a milestone and release escrow. |
| POST | /v1/webhooks | Subscribe to platform events: order, milestone, payout, dispute. |
Every order, milestone, and payout fires a webhook event. Verified via HMAC-SHA256 with a per-endpoint secret.
{
"event": "milestone.approved",
"id": "evt_01HX...",
"occurred_at": "2026-05-01T08:42:11Z",
"data": {
"order_id": "ord_1029",
"milestone": {
"index": 2,
"label": "MVP agent on staging",
"amount_usd": 375,
"released_at": "2026-05-01T08:42:11Z"
},
"expert_id": "exp_001",
"client_id": "usr_8201"
}
}Officially supported in TypeScript and Python. Community-maintained for Go and PHP.
Instant approval for Business accounts. Otherwise we'll review and reply inside one business day.