CorefinityCorefinityDocs
Open the Control PanelControl Panel
Team · 11 of 17

List your team

Answers your company's people and those invited into it, by name: everybody whose status is active, invite_sent or invite_expired. Paged by cursor: send next_cursor back as cursor; null means the last page.

GET/api/team/members

Query parameters

limitinteger

Items a page. Defaults to 25. 1 to 100.

cursorstring

The next_cursor of the previous answer. Anything that is not a page number of up to nine digits is refused 422 on cursor.

searchstring

Lists only people whose name or email address contains this text. Up to 255 characters.

Returns

200 One page of the team.

Fields of the 200 answer
dataobjectRequired

The paging field of a cursor-paged list. The list itself sits beside it under a key each endpoint names, such as items or sites.

Fields
next_cursorstring or nullRequired

Send as cursor to read the next page. Null on the last page.

itemsarray of objectsRequired
Fields of each item
company_idinteger or nullRequired

At least 1.

emailstringRequired

The address the person is shown with. For somebody invited who has not accepted, the address they were invited at.

idintegerRequired

At least 1.

invitation_expires_atstring or nullRequired

When the invitation expires, in UTC, written with +00:00. Format: date-time.

invited_atstring or nullRequired

When the invitation was last sent, in UTC, written with +00:00. Format: date-time.

namestringRequired
notificationsobjectRequired

The person's notification preferences.

Fields
alerts_notificationsboolean
email_notificationsboolean
maintenance_window_notificationsboolean
subscribe_to_deployment_alertsboolean
subscribe_to_emergency_alertsboolean
subscribe_to_newslettersboolean
positionstring or nullRequired
rolesarray of objectsRequired

The person's roles, by name.

Fields of each item
namestringRequired
slugstringRequired
statusstringRequired

The team list holds active, invite_sent and invite_expired; one person read by id can have any of these.

unassignedpending_inviteinvite_sentactiveinactiveinvite_expiredunknown

If it is refused

StatusReasonWhat to do
401noneSend a valid token as Authorization: Bearer <token>.
403scope_requiredUse a token with the scope named in scope.
422invalidFix the field named in field; errors says why.
429rate_limitedWait for the seconds in Retry-After.

Reasons are listed by name in Errors and refusals.

The same task elsewhere

curl https://manage.corefinity.com/api/team/members \
  -H "Authorization: Bearer $COREFINITY_TOKEN" \
  -H "Accept: application/json"
{
  "data": {
    "items": [
      {
        "company_id": 1204,
        "email": "[email protected]",
        "id": 2044,
        "invitation_expires_at": "2026-11-16T10:15:00+00:00",
        "invited_at": "2026-11-09T10:15:00+00:00",
        "name": "Rosa Whitlock",
        "notifications": {
          "alerts_notifications": true,
          "email_notifications": true,
          "maintenance_window_notifications": true,
          "subscribe_to_deployment_alerts": true,
          "subscribe_to_emergency_alerts": true,
          "subscribe_to_newsletters": false
        },
        "position": null,
        "roles": [
          {
            "name": "Member (Full Access)",
            "slug": "client-member-full"
          }
        ],
        "status": "invite_sent"
      },
      {
        "company_id": 1204,
        "email": "[email protected]",
        "id": 2042,
        "invitation_expires_at": null,
        "invited_at": null,
        "name": "Tom Harbour",
        "notifications": {
          "alerts_notifications": true,
          "email_notifications": true,
          "maintenance_window_notifications": true,
          "subscribe_to_deployment_alerts": true,
          "subscribe_to_emergency_alerts": true,
          "subscribe_to_newsletters": false
        },
        "position": "Developer",
        "roles": [
          {
            "name": "Member (Full Access)",
            "slug": "client-member-full"
          }
        ],
        "status": "active"
      }
    ],
    "next_cursor": null
  }
}
Try it
Held in this tab's memory only. Never stored or sent to us.

Use a token with only the read scope. How to make one

Was this helpful?
Open in ClaudeOpen in ChatGPT