Skip to main content
Browse the docs

Get a team membership

GET/api/v1/memberships/{id}

  • Needs an API key, and runs with the access of the member who made the key.
  • A connected AI assistant can use it too, as getMembership.

Parameters

In the address

  • idstring (uuid)required

Responses

200Membership details.

  • dataobjectrequired

    Fields(10)

    • lock_versioninteger

      At least 0.

    • created_atstring (date-time)required

    • updated_atstring (date-time)required

    • idstring (uuid)required

    • account_idstring (uuid)required

    • userobjectrequired

      Fields(5)

      • idstring (uuid)required

      • namestringrequired

      • emailstring (email)required

      • time_zonestringrequired

      • has_passwordbooleanrequired

        False for people who only ever sign in with Google, Microsoft or Apple. Says which confirmation `deleteAccount` should ask for.

    • rolestringrequired

      One of: owner, office, technician.

    • calendar_colorstring or null

    • activebooleanrequired

    • invitedbooleanrequired

      True until the member sets a password from their invitation email.

A refusal answers in the one error shape every operation shares.

Example

A request our own tests send. The ids are made up: put your own in their place.

curl "https://app.tradesender.co.uk/api/v1/memberships/36c7095b-fcec-58a6-b1e1-916bdae515d3" \
  -H "Authorization: Bearer $TRADESENDER_KEY"