Skip to main content

Retrieve a person​

Get a person object by its ID. The function returns the decrypted, abridged person record.

Please use the Attributes API to retrieve custom person attributes.

Path Parameters
  • person_id string required

    The person ID

    Example: 903c1ff9-f2cc-435c-b242-9d8a690fcf0a
Query Parameters
  • fields string[]

    Possible values: [handles, groups, attributes]

    Optional fields to include in the response

Header Parameters
  • SlashID-OrgID string required

    The organization ID

    Example: af5fbd30-7ce7-4548-8b30-4cd59cb2aba1
Responses

OK

Schema
  • meta object
  • pagination object
  • limit integer
  • offset integer
  • total_count int64
  • errors object[]
  • httpcode integer
  • message string
  • result object

    Abridged person structure

  • active boolean

    A flag indicating whether the person is active or not

  • person_id string

    The ID of the person

  • roles string[]

    A custom list of roles for the person

  • region string
  • handles object[]
  • type string

    Possible values: [email_address, phone_number]

  • value string
  • groups string[]

    Possible values: Value must match regular expression ^[A-Za-z0-9]{1}[\w\.\-]{0,98}[A-Za-z0-9]$

  • attributes object

    Attributes divided into named buckets. Bucket names are top level keys; attributes are values. Attributes consist of key-value pairs. Attribute names (keys) may be at most 70 bytes long. Attribute values must be JSON-serializable.

  • property name*