---
title: "Get EntrySchema by ID"
method: GET
path: "/api/v3/entry-schema/{entry_schema_id}"
tags: ["Entry Schema"]
---

# Get EntrySchema by ID

`GET /api/v3/entry-schema/{entry_schema_id}`

## Request

- Base URL: `https://{tenant_name}.benchling.com`
- URL: `https://{tenant_name}.benchling.com/api/v3/entry-schema/{entry_schema_id}`
- Auth: HTTP bearer

Get a single EntrySchema by ID.

## Path parameters

- `entry_schema_id` string, required

## Query parameters

- `returning` string[]
- `omit` string[]

## Headers

- `EARLY-ACCESS` string

## Response `200`

OK

- EntrySchema: Defines a schema that can be applied to Entries to add structured metadata through custom fields. Entry schemas allow organizations to standardize the information captured in notebook entries by defining required or optional fields with specific data types.
  - `__typename` string
  - `archiveReason` string, nullable
  - `archived` boolean
  - `createdAt` string, datetime, nullable
  - `description` string
  - `fieldDefinitions` string, uri
  - `iconId` string: Use typedIconId instead, which provides enum validation.
  - `id` string
  - `itemIdPrefix` string
  - `modifiedAt` string, datetime
  - `name` string
  - `organization` OrganizationRef
    - `__typename` string
    - `id` string, api_id
  - `systemName` string
  - `typedIconId` 'ENTRY'

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `404`: Not Found
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/benchling/apis/benchling-api.md) - [All operations](https://skmtc.dev/benchling/apis/benchling-api/llms.txt) - [OpenAPI document](https://skmtc.dev/benchling/apis/benchling-api/revisions/3873a10bf7b8?raw)