Open App

Organizations

API endpoints for organizations

List organizations available to the token

GET /api/v1/organizations

Parameters

NameInTypeRequiredDescription
limitqueryintegerNoMaximum number of items to return.
offsetqueryintegerNoNumber of items to skip.

Example request

curl -X GET \
"https://api.getpilfer.com/api/v1/organizations?limit=<limit>&offset=<offset>" \
-H "Authorization: Bearer <API_KEY>" \
-H "Content-Type: application/json"

Example response

Status: 200

{
  "data": [
    {
      "id": "string",
      "name": "string"
    }
  ]
}

Other statuses: 401, 403.

Response body type

{ data: Organization[] }


Get organization by WorkOS id

GET /api/v1/organizations/{id}

Parameters

NameInTypeRequiredDescription
idpathstringYes

Example request

curl -X GET \
"https://api.getpilfer.com/api/v1/organizations/<id>" \
-H "Authorization: Bearer <API_KEY>" \
-H "Content-Type: application/json"

Example response

Status: 200

{
  "data": {
    "id": "string",
    "name": "string"
  }
}

Other statuses: 401, 403, 404.

Response body type

{ data: Organization }