Skip to main content
GET
/
scopes
curl -X GET 'https://api.example.com/scopes?ids=scope_1,scope_2' \
  -H 'Authorization: Bearer YOUR_TOKEN'

[
  {
    "id": "scope_1",
    "name": "Acme Organization",
    "typeId": "type_org",
    "externalId": "org-acme"
  },
  {
    "id": "scope_2",
    "name": "Engineering Team",
    "typeId": "type_team",
    "externalId": "team-eng"
  }
]

​
Query Parameters

​
ids
string
Comma-separated list of scope IDs to retrieve

​
Response

Returns an array of scope objects.
​
scopes
array
curl -X GET 'https://api.example.com/scopes?ids=scope_1,scope_2' \
  -H 'Authorization: Bearer YOUR_TOKEN'

[
  {
    "id": "scope_1",
    "name": "Acme Organization",
    "typeId": "type_org",
    "externalId": "org-acme"
  },
  {
    "id": "scope_2",
    "name": "Engineering Team",
    "typeId": "type_team",
    "externalId": "team-eng"
  }
]