Everything you need to enrich your first restaurant.

curl -sS -X POST "https://ora.248.ai/api/v1/auth/register" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "operator@example.com",
    "first_name": "Ada",
    "last_name": "Lovelace"
  }'

curl -sS -X POST "https://ora.248.ai/api/v1/auth/verify" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "operator@example.com",
    "code": "123456"
  }'

curl -sS -X POST "https://ora.248.ai/api/v1/auth/api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "verification_grant": "verification-grant-from-verify"
  }'

Key recovery and rotation

curl -sS -X POST "https://ora.248.ai/api/v1/credits/purchase" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: rk_live_your_key" \
  -d '{"pack_id": "100"}'

Open the returned checkout_url to complete payment.

curl -sS "https://ora.248.ai/v1/enrichment/fields" \
  -H "X-API-Key: rk_live_your_key"

Submit only fields where requestable is true. The planner automatically adds prerequisites required to produce the requested outputs.

curl -sS -X POST "https://ora.248.ai/v1/enrichment/jobs" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: rk_live_your_key" \
  -d '{
    "idempotency_key": "boka-2026-07-22",
    "name": "Boka",
    "address": "1729 N Halsted St, Chicago, IL",
    "fields": ["pos", "emails", "owner_linkedin"],
    "force_refresh": false
  }'

Example result

{
  "job_id": "5be0a05c-4ef9-4e31-b9b0-69a412fa9dc0",
  "status": "completed",
  "name": "Boka",
  "address": "1729 N Halsted St, Chicago, IL",
  "location_id": "2a45f697-391b-4902-9287-7e204b224d96",
  "fields": {
    "pos": {
      "status": "completed",
      "value": "Toast",
      "reasoning": "Provider evidence found on the restaurant website.",
      "evidence_url": "https://example.com/order",
      "evidence_urls": ["https://example.com/order"],
      "source_workflow": "pos-v1",
      "source_item_type": "pos"
    }
  }
}

Every requested field has its own status and value. When available, Ora also returns reasoning, evidence URLs, and source workflow metadata.

curl -sS -X POST "https://ora.248.ai/v1/locations/search" \
  -H "Authorization: Bearer your_issued_location_search_key" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "search",
    "text": {
      "query": "tacos al pastor",
      "fields": ["menu"]
    },
    "filters": [
      {"field": "location.state", "op": "eq", "value": "CA"},
      {"field": "features.supports_delivery", "op": "eq", "value": true}
    ],
    "sort": [
      {"field": "google.rating_count", "direction": "desc"}
    ],
    "include": {
      "fields": ["pos", "online_ordering_delivery_providers"],
      "field_results": true
    },
    "page": {"size": 25, "offset": 0}
  }'

curl -sS -X POST "https://ora.248.ai/v1/locations/search" \
  -H "Authorization: Bearer your_issued_location_search_key" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "count",
    "filters": [
      {"field": "location.state", "op": "eq", "value": "CA"},
      {"field": "pos.provider", "op": "eq", "value": "Toast"}
    ]
  }'

Supported query field families

Example response

{
  "mode": "search",
  "total": 418,
  "results": [
    {
      "location_id": "2a45f697-391b-4902-9287-7e204b224d96",
      "score": 8.42,
      "location": {
        "name": "Example Taqueria",
        "city": "San Francisco",
        "state": "CA"
      },
      "fields": {
        "pos": "Toast",
        "online_ordering_delivery_providers": ["Uber Eats"]
      },
      "field_results": {}
    }
  ],
  "page": {"size": 25, "offset": 0},
  "metadata": {}
}

curl -sS -X POST \
  "https://ora.248.ai/v1/enrichment/online-ordering/open-status-hours/jobs" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: rk_live_your_key" \
  -H "Idempotency-Key: tartine-uptime-2026-07-28" \
  -d '{
    "name": "Tartine Bakery",
    "address": "600 Guerrero St, San Francisco, CA 94110"
  }'

curl -sS -X POST \
  "https://ora.248.ai/v1/enrichment/online-ordering/open-status-hours/jobs" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: rk_live_your_key" \
  -H "Idempotency-Key: location-uptime-2026-07-28" \
  -d '{
    "location_id": "c6126ebf-9586-422d-9e7a-31095f79e3f4"
  }'

curl -sS \
  "https://ora.248.ai/v1/enrichment/online-ordering/open-status-hours/jobs/$JOB_ID" \
  -H "X-API-Key: rk_live_your_key"

Poll until status is completed, failed, or cancelled. While a job is queued or running, honor the response's Retry-After header.

Completed response

{
  "job_id": "0b50aa5c-4b05-4b42-9c04-cafd9c898876",
  "request": {
    "name": "Tartine Bakery",
    "address": "600 Guerrero St, San Francisco, CA 94110"
  },
  "location_id": "c6126ebf-9586-422d-9e7a-31095f79e3f4",
  "status": "completed",
  "created_at": "2026-07-28T21:49:37.968516Z",
  "checked_at": "2026-07-28T21:50:04.507231Z",
  "finished_at": "2026-07-28T21:50:09.798203Z",
  "result": {
    "google": {
      "place_id": "ChIJBVY2Bxh-j4ARa2zO8Jd6H2A",
      "name": "Tartine Bakery",
      "address": "600 Guerrero St, San Francisco, CA 94110, USA"
    },
    "uber_eats": {
      "accepting_orders": true,
      "reason": "accepting_orders",
      "url": "https://www.ubereats.com/store/tartine-bakery/B44a6r9vXumvKlrvPZmrmw?diningMode=PICKUP"
    }
  }
}