Skip to content

Custom Objects API

Get an object type

GEThttps://email.growthdept.ai/api/object-types/{id}

Rate limits

Burst: 3/s

Steady: 60/m

Tier S. See rate limits for how requests are counted.

Scopes

custom-objects:read

Operation id

get_object_type The same operation as in Klaviyo's API. OpenAPI document

Path parameters

stringrequired

Query parameters

array of strings

Attributes of object-schema resources to return.

Sparse fieldsets guide

Pick values to add them to the request:

array of strings

Attributes of object-type resources to return.

Sparse fieldsets guide

Pick values to add them to the request:

array of strings

Attributes of profile-object-type resources to return.

Sparse fieldsets guide

Pick values to add them to the request:

array of strings

Related resources to side-load.

Includes guide

Pick values to add them to the request:

Headers

stringrequireddefault 2026-10-15

API revision, YYYY-MM-DD. This server implements 2026-10-15.

Revisions guide

Responses

200Success

Response body

object

  • dataobjectrequired

    data: 5 fields
    • typestringrequired

      object-type
    • idstringrequired

    • attributesobjectrequired

      attributes: 6 fields
      • titlestringrequired

      • descriptionstringrequired

      • statusstringrequired

        activedraftpublishingundefined
      • namespacestringrequired

      • created_atstring (date-time)required

      • updated_atstring (date-time)required

    • relationshipsobject

      relationships: 5 fields
      • current-schemaobject

        current-schema: 2 fields
        • dataobject

          data: 2 fields
          • typestringrequired

            object-schema
          • idstringrequired

        • linksobject

          links: 2 fields
          • selfstring (uri)required

          • relatedstring (uri)required

      • draft-schemaobject

        draft-schema: 2 fields
        • dataobject

          data: 2 fields
          • typestringrequired

            object-schema
          • idstringrequired

        • linksobject

          links: 2 fields
          • selfstring (uri)required

          • relatedstring (uri)required

      • schema-versionsobject

        schema-versions: 2 fields
        • dataarray of objects

          data: 2 fields
          • typestringrequired

            object-schema
          • idstringrequired

        • linksobject

          links: 2 fields
          • selfstring (uri)required

          • relatedstring (uri)required

      • object-typesobject

        object-types: 2 fields
        • dataarray of objects

          data: 2 fields
          • typestringrequired

            object-type
          • idstringrequired

        • linksobject

          links: 2 fields
          • selfstring (uri)required

          • relatedstring (uri)required

      • profile-object-typesobject

        profile-object-types: 2 fields
        • dataarray of objects

          data: 2 fields
          • typestringrequired

            profile-object-type
          • idstringrequired

        • linksobject

          links: 2 fields
          • selfstring (uri)required

          • relatedstring (uri)required

    • linksobjectrequired

      links: 1 field
      • selfstring (uri)required

  • includedarray of objects

    One option: ObjectTypeRelationshipResponseObjectResource
    • typestringrequired

      object-type
    • idstringrequired

    • linksobjectrequired

      links: 1 field
      • selfstring (uri)required

    • metaobjectcan be null

      meta: 3 fields
      • relationship_idstringrequired

      • namestringrequired

      • descriptionstringcan be null

    One option: ObjectSchemaResponseObjectResource
    • typestringrequired

      object-schema
    • idstringrequired

    • attributesobjectrequired

      attributes: 7 fields
      • titlestringrequired

      • descriptionstringrequired

      • statusstringrequired

        activedraftpublishingundefined
      • propertiesarray of objectsrequired

        properties: 4 fields
        • idintegerrequired

        • namestringrequired

        • typestringrequired

          booleanfloatintlist_strstringtimestamp
        • descriptionstringcan be null

      • requiredarray of stringsrequired

      • published_atstring (date-time)can be null

      • visibilitystringrequired

        privateshared
    • relationshipsobject

      relationships: 3 fields
      • source-mappingobject

        source-mapping: 2 fields
        • dataobject

          data: 2 fields
          • typestringrequired

            source-mapping
          • idstringrequired

        • linksobject

          links: 2 fields
          • selfstring (uri)required

          • relatedstring (uri)required

      • object-schemasobject

        object-schemas: 2 fields
        • dataarray of objects

          data: 2 fields
          • typestringrequired

            object-schema
          • idstringrequired

        • linksobject

          links: 2 fields
          • selfstring (uri)required

          • relatedstring (uri)required

      • profile-object-schemasobject

        profile-object-schemas: 2 fields
        • dataarray of objects

          data: 2 fields
          • typestringrequired

            profile-object-schema
          • idstringrequired

        • linksobject

          links: 2 fields
          • selfstring (uri)required

          • relatedstring (uri)required

    • linksobjectrequired

      links: 1 field
      • selfstring (uri)required

    One option: ProfileTypeRelationshipResponseObjectResource
    • typestringrequired

      profile-object-type
    • idstringrequired

    • linksobjectrequired

      links: 1 field
      • selfstring (uri)required

    • metaobjectcan be null

      meta: 3 fields
      • relationship_idstringrequired

      • namestringrequired

      • descriptionstringcan be null

  • linksobject

    links: 1 field
    • selfstring (uri)required

  • metaobject

4XXClient error

Response body

object

  • errorsarray of objectsrequired

    errors: 8 fields
    • idstringrequired

    • statusintegerrequired

    • codestringrequired

    • titlestringrequired

    • detailstringrequired

    • sourceobject

      source: 2 fields
      • pointerstring

      • parameterstring

    • linksobject

    • metaobject

See status codes for each code.

5XXServer error

Response body

object

  • errorsarray of objectsrequired

    errors: 8 fields
    • idstringrequired

    • statusintegerrequired

    • codestringrequired

    • titlestringrequired

    • detailstringrequired

    • sourceobject

      source: 2 fields
      • pointerstring

      • parameterstring

    • linksobject

    • metaobject