> ## Documentation Index
> Fetch the complete documentation index at: https://docs.omophub.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Concept Relationships by Type

> Retrieve one relationship type for a concept using the relationship type as a path parameter.

Returns relationships whose `relationship_id` exactly matches the path value.
For new integrations, prefer [List Relationships for a Concept](https://docs.omophub.com/api-reference/relationships/get-concept-relationships.md)
with the `relationship_ids` query parameter; that endpoint also supports
validity, vocabulary, domain, direction, and standard-concept filters.

> [!NOTE]
>
> The path value is case-sensitive and may contain spaces. URL-encode values
> such as `Is a` as `Is%20a`.

> [!WARNING]
>
> This compatibility shortcut includes invalid relationships and concepts. Use
> the canonical relationship endpoint with `relationship_ids` and the default
> `include_invalid=false` when you only want current records.

## Path Parameters

**concept\_id** `integer` *required*

Concept whose outgoing relationships are returned.

**relationship\_type** `string` *required*

Exact OMOP relationship identifier, for example `Is a` or `Maps to`.

## Query Parameters

**page** `integer` (default: 1)

Page number, using one-based indexing.

**page\_size** `integer` (default: 20)

Relationships per page. Values above 200 are clamped to 200.

**vocab\_release** `string`

Vocabulary release to query. When omitted, the current default release is
used.

## Response

**success** `boolean`

Whether the lookup completed.

**data** `array`

Matching relationships for the requested page.

**Relationship object**

**concept\_id\_1** `integer`

Stored source concept identifier.

**concept\_id\_2** `integer`

Stored target concept identifier.

**relationship\_id** `string`

Relationship identifier matched by the path value.

**relationship\_name** `string`

Relationship display name.

**reverse\_relationship\_id** `string`

Identifier for the reverse relationship.

**concept\_1** `object`

Stored source concept.

**Source concept**

**concept\_id** `integer`

Concept identifier.

**concept\_name** `string`

Concept name.

**concept\_code** `string`

Source vocabulary code.

**vocabulary\_id** `string`

Vocabulary identifier.

**vocabulary\_name** `string`

Vocabulary name.

**domain\_id** `string`

OMOP domain.

**concept\_class\_id** `string`

Concept class.

**standard\_concept** `string|null`

Standard-concept flag.

**valid\_start\_date** `string`

Validity start timestamp.

**valid\_end\_date** `string`

Validity end timestamp.

**invalid\_reason** `string|null`

Invalidity marker, or `null`.

**concept\_2** `object`

Stored target concept.

**Target concept**

**concept\_id** `integer`

Concept identifier.

**concept\_name** `string`

Concept name.

**concept\_code** `string`

Source vocabulary code.

**vocabulary\_id** `string`

Vocabulary identifier.

**vocabulary\_name** `string`

Vocabulary name.

**domain\_id** `string`

OMOP domain.

**concept\_class\_id** `string`

Concept class.

**standard\_concept** `string|null`

Standard-concept flag.

**valid\_start\_date** `string`

Validity start timestamp.

**valid\_end\_date** `string`

Validity end timestamp.

**invalid\_reason** `string|null`

Invalidity marker, or `null`.

**valid\_start\_date** `string`

Relationship validity start timestamp.

**valid\_end\_date** `string`

Relationship validity end timestamp.

**invalid\_reason** `string|null`

Relationship invalidity marker, or `null`.

**meta** `object`

**Response metadata**

**request\_id** `string`

Unique request identifier.

**timestamp** `string`

ISO 8601 response timestamp.

**vocab\_release** `string`

Vocabulary release used.

**pagination** `object`

**Pagination**

**page** `integer`

Current page.

**page\_size** `integer`

Requested effective page size.

**total\_items** `integer`

Number of matching relationships.

**total\_pages** `integer`

Number of pages.

**has\_next** `boolean`

Whether another page exists.

**has\_previous** `boolean`

Whether a previous page exists.

```bash cURL theme={null}
curl -G "https://api.omophub.com/v1/concepts/201826/relationships/Is%20a" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "page_size=20"
```

```json Response theme={null}
{
  "success": true,
  "data": [
    {
      "concept_id_1": 201826,
      "concept_id_2": 201820,
      "relationship_id": "Is a",
      "relationship_name": "Is a",
      "reverse_relationship_id": "Subsumes",
      "concept_1": {
        "concept_id": 201826,
        "concept_name": "Type 2 diabetes mellitus",
        "concept_code": "44054006",
        "vocabulary_id": "SNOMED",
        "vocabulary_name": "Systematic Nomenclature of Medicine - Clinical Terms (IHTSDO)",
        "domain_id": "Condition",
        "concept_class_id": "Disorder",
        "standard_concept": "S",
        "valid_start_date": "2002-01-31T00:00:00.000Z",
        "valid_end_date": "2099-12-31T00:00:00.000Z",
        "invalid_reason": null
      },
      "concept_2": {
        "concept_id": 201820,
        "concept_name": "Diabetes mellitus",
        "concept_code": "73211009",
        "vocabulary_id": "SNOMED",
        "vocabulary_name": "Systematic Nomenclature of Medicine - Clinical Terms (IHTSDO)",
        "domain_id": "Condition",
        "concept_class_id": "Disorder",
        "standard_concept": "S",
        "valid_start_date": "2002-01-31T00:00:00.000Z",
        "valid_end_date": "2099-12-31T00:00:00.000Z",
        "invalid_reason": null
      },
      "valid_start_date": "2011-07-31T00:00:00.000Z",
      "valid_end_date": "2099-12-31T00:00:00.000Z",
      "invalid_reason": null
    }
  ],
  "meta": {
    "request_id": "7833dc90-cbc3-4034-9ebe-9219330d8f9e",
    "timestamp": "2026-09-12T22:28:47.416Z",
    "vocab_release": "2026.2",
    "pagination": {
      "page": 1,
      "page_size": 20,
      "total_items": 1,
      "total_pages": 1,
      "has_next": false,
      "has_previous": false
    }
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.