Search providers by free-text query | CAIL Health

{
  "data": [
    {
      "providerId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "name": "St Thomas' Hospital",
      "address": {
        "line": [
          "Westminster Bridge Road"
        ],
        "city": "London",
        "district": "Greater London",
        "postalCode": "SE1 7EH"
      },
      "phone": "+442071887188",
      "website": "https://example.nhs.uk",
      "coordinates": {
        "latitude": 51.4988,
        "longitude": -0.1187
      },
      "distanceMetres": null,
      "serviceTypes": [
        "50849002"
      ],
      "isOpenNow": true,
      "availabilityStatus": "open_now",
      "routingReasonCodes": [
        "match.service_type",
        "match.open_now"
      ],
      "action": {
        "kind": "call",
        "phone": "+442071887188"
      },
      "confidence": {
        "level": "high",
        "reasonCodes": [
          "data.has_hours",
          "data.recent_wait_time"
        ]
      },
      "waitTime": {
        "medianMinutes": 22,
        "reportCount": 14,
        "isStale": false,
        "newestReportAt": "2026-05-12T14:21:00.000Z"
      }
    }
  ],
  "pagination": {
    "total": 1,
    "limit": 10,
    "offset": 0,
    "hasMore": false
  },
  "meta": {
    "requestId": "4a3b2c1d-5e6f-4890-9abc-def0fedcba98",
    "timestamp": "2026-05-13T14:21:00.000Z",
    "durationMs": 38
  }
}

Returns providers matching the supplied query, ranked by full-text relevance. Searches the provider name, address, postcode, and specialty. Results are restricted to the operator’s jurisdiction and the operator’s service scope. Each result carries operational signals (open hours, recent wait times) and a coarse data-quality tier so the network can be triaged without a second round-trip. Use the offset/limit parameters to step through large result sets; the response includes a hasMore flag and a running total.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

querystringRequired

Free-text query against provider name, address, postcode, and specialty.

serviceTypeCodestringOptional

Restrict results to providers offering this service type.

limitdoubleOptional1-50

Maximum number of results to return. Defaults to 10. Maximum 50.

offsetdoubleOptional>=0

Zero-based offset into the result set. Defaults to 0.

Response

A page of providers matching the text query.

datalist of objects

Provider rows matching the query, ranked by relevance.

paginationobject

Pagination metadata for stepping forward by offset.

metaobject