Labs

List nearby lab draw sites

get

Returns nearby Patient Service Centers (lab draw sites) for a US zip code, used when placing a GO_TO_LAB order.

Authorizations

AuthorizationstringRequired

Authenticate with your Terra API credentials: username = your Terra dev-id, password = your Terra API key — the same credentials used for every other Terra API. The header pair dev-id + x-api-key is also accepted. Suspended credentials receive 403; accounts without the Vantage entitlement receive 403 once entitlement enforcement is enabled.

Query parameters

zip_codestringRequired

5-digit US zip (optionally with 4-digit suffix)

Example: 10001

Responses

200

Nearby lab draw sites

application/json

400

Missing or invalid zip code

application/json

401

Missing or invalid credentials

application/json

500

Internal server error

application/json

get/api/v1/labs

GET /api/v1/labs?zip_code=10001 HTTP/1.1
Host: vantage.tryterra.co
Authorization: Basic username:password
Accept: */*

{
  "labs": [
    {
      "code": "PSC12345",
      "name": "Quest Diagnostics - Midtown",
      "address": {
        "address_line_1": "123 Baker Street",
        "address_line_2": "Flat 4B",
        "administrative_area": "Greater London",
        "city": "London",
        "country_code": "GB",
        "id": 987654321,
        "is_validated": true,
        "postal_code": "NW1 6XE"
      },
      "phone": "[phone]",
      "hours": {
        "monday": "08:00-17:00"
      },
      "latitude": 40.7549,
      "longitude": -73.984,
      "scheduling": true,
      "distance": 1
    }
  ]
}