---
title: "Get Hub by coordinates"
method: GET
path: "/api/v4/hub"
tags: ["Hubs"]
---

# Get Hub by coordinates

`GET /api/v4/hub`

Look up hub meeting-point data for a given set of coordinates.

A **hub** is a large venue (e.g. airport, train station) with designated pick-up/drop-off meeting points. Use this endpoint to determine if a location is within a hub and retrieve the available meeting points.

## Response

- If a hub exists at the given coordinates, returns the hub with its meeting points (uid, title, coordinates, images, and localized instructions).
- If no hub exists or the lookup fails, returns `{ "data": null }`.

## Usage

This endpoint is useful when you want to look up hub data independently from the estimation flow. For example:
1. User enters a pickup address
2. Call this endpoint with the address coordinates
3. If a hub is returned, present the meeting points to the user
4. Include the selected meeting point **and** the hub's `location_id` in the corresponding stop of the `POST /api/v4/journey` request

> 📘 Hub data in Estimates
>
> Hub data is also returned as part of the `POST /api/v4/estimates` response (best-effort, origin stop only).
> Use this standalone endpoint when you need hub data without creating an estimate, or when the estimate did not resolve hub data in time.

## Query parameters

- `latitude` number, required
- `longitude` number, required

## Response `200`

Success

- HubResponse — Hub information for a given set of coordinates. Returns null inside the data field when no hub exists at those coordinates.
  - `data` HubObject, nullable — A hub is a large venue (e.g. airport, train station) with designated pick-up/drop-off meeting points.
    - `active` boolean — Whether the hub is currently active.
    - `location_id` string — Location identifier used to look up this hub.
    - `meeting_points` object[] — Designated pick-up/drop-off points within the hub. Present one of these to the user as their boarding location.
      - `bottom_image_url` string, nullable — URL for the bottom image of the meeting point.
      - `coordinates` object — GPS coordinates of the meeting point.
        - `latitude` number
        - `longitude` number
      - `header_image_url` string, nullable — URL for the header image of the meeting point.
      - `instructions` object[] — Step-by-step instructions to reach the meeting point.
        - `en` string
        - `es` string
        - `step_image_url` string, nullable
      - `title` object — Localized name of the meeting point, keyed by BCP 47 language tag.
      - `uid` string — Unique identifier of the meeting point.
    - `title` object — Localized name of the hub, keyed by BCP 47 language tag.
    - `uid` string — Unique identifier of the hub.

## Other responses

- `400` — Bad request
- `401` — Unauthorized

---

[API](https://skmtc.dev/cabify/apis/ride-hailing-api.md) · [All operations](https://skmtc.dev/cabify/apis/ride-hailing-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cabify/ride-hailing-api/revisions/8da1cb1270df/schema)