API Reference / Relationship Types

GET /relationship_types/{relationship_type_id}

Get a specific relationship type

Returns one relationship type with its variants. A single variant means the type is symmetrical and both contacts get the same label; two variants mean each end of the relationship gets a different one.

Path parameters

Name Type Description
relationship_type_id req string Relationship type ID

Responses

200 OK
  • statusintegerint32

    Response code

  • messagestring

    Response message

  • timestampintegerunix-timestamp

    Response time

  • dataobject
    object fields →
    • relationship_typeobject

      The relationship types that identifies the relationships between the contacts.

      object fields →
      • idstringbson-id

        ID of the relationship type

      • symmetricalboolean

        Is the relationship symmetrical? (read only).

      • relationship_variantsarray<object>required

        The directional variants of this relationship type.

        array item fields →
        • idstringbson-id

          ID of the relationship type

        • namestring

          The relationship variant name

      • created_atstringdate-time

        Creation time of the relationship type

      • modified_atstringdate-time

        Last modification time of the relationship type

Standard error responses: 400 · 401 · 403 · 404 · 409 · 500 — shared across the API. See Errors.

Related guides