# Get record

`GET https://api.airtable.com/v0/{baseId}/{tableIdOrName}/{recordId}`

Retrieve a single record. Any "empty" fields (e.g. **""**, **[]**, or **false**) in the record will not be returned.

**Note** If we can't locate the record on a given table, the request will fallback to a base wide search and will still return the record if the Record ID is valid and the record is located within the same base.

## Requirements

- **Authentication:** [Personal access token](https://airtable.com/developers/web/api/authentication.md#types-of-token), [OAuth integration](https://airtable.com/developers/web/api/authentication.md#types-of-token)
- **Scope:** [`data.records:read`](https://airtable.com/developers/web/api/scopes.md#data-records-read)
- **User role:** Base read-only
- **Billing plans:** All plans

## Path parameters

- `baseId: string`

- `tableIdOrName: string`

- `recordId: string`

## Query parameters

- `cellFormat: "json" | "string"` — optional

  The format that should be used for cell values. Supported values are:

   - `json:` cells will be formatted as JSON, depending on the field type.
   - `string:` cells will be formatted as user-facing strings, regardless of the field type. The `timeZone` and `userLocale` parameters are required when using `string` as the `cellFormat`.

  **Note:** You should not rely on the format of these strings, as it is subject to change.

  The default is `json`.

- `returnFieldsByFieldId: boolean` — optional

  An optional boolean value that lets you return field objects where the key is the field id.

  This defaults to `false`, which returns field objects where the key is the field name.

- `includeDateDependencyMetadata: boolean` — optional

  An optional boolean value that returns linked record cell values as objects instead of record IDs.

  When `true`, all linked record fields return an array of objects with an `id` property.
  Linked record fields configured for date dependencies include an optional
  `dateDependencyMetadata` object with `dependencyType` and `buffer` fields (when date dependencies are configured
  in fixed mode).
  When `false` or unset, linked record fields return an array of record ID strings.

  This defaults to `false`.

## Response format

- `id: string` — required

  Record ID

- `createdTime: string` — required

  A date timestamp in the ISO format, eg:"2018-01-01T00:00:00.000Z"

- `fields: object` — required

  Cell values are keyed by either field name or field ID (conditioned on `returnFieldsByFieldId`).

  See [Cell Values](https://airtable.com/developers/web/api/field-model.md) for more information on cell value response types.

  - `[key: string]` — [Cell value](https://airtable.com/developers/web/api/field-model.md)

### Example — Success response

```sh
curl "https://api.airtable.com/v0/{baseId}/{tableIdOrName}/{recordId}" \
-H "Authorization: Bearer YOUR_TOKEN"
```

```json
{
  "createdTime": "2022-09-12T21:03:48.000Z",
  "fields": {
    "Address": "333 Post St",
    "Name": "Union Square",
    "Visited": true
  },
  "id": "rec560UJdUtocSouk"
}
```