Fiest Developers

List authorized Management organizations

Returns every organization and reviewed restaurant snapshot in a bounded Management portfolio authorization.

GET
/v1/organizations

Returns every organization and reviewed restaurant snapshot in a bounded Management portfolio authorization. authorizedRestaurantCount counts distinct restaurant UUIDs, while the organization arrays preserve every exact association. Use an exact returned organizationId as organization_id on restaurant-scoped calls whenever more than one organization is present.

Quick request

Example Request
curl -X GET 'https://api-sandbox.fiest.io/v1/organizations' \  -H 'Authorization: Bearer $FIEST_ACCESS_TOKEN'
Example Response
{  "data": {    "organizations": [      {        "organizationId": "33333333-3333-4333-8333-333333333333",        "organizationName": "Fiest Sandbox South",        "role": "admin",        "restaurants": [          {            "restaurantId": "11111111-1111-4111-8111-111111111111",            "restaurantName": "Fiest Sandbox Helsinki",            "businessIdentity": {              "registeredName": "Fiest Sandbox Restaurants Oy",              "businessId": "1234567-8"            }          }        ],        "restaurantsTruncated": false,        "authorizationCoverage": {          "authorizedRestaurantCount": 1,          "currentRestaurantCount": 1,          "additionalRestaurantCount": 0,          "reauthorizationAvailable": false        }      },      {        "organizationId": "44444444-4444-4444-8444-444444444444",        "organizationName": "Fiest Sandbox North",        "role": "owner",        "restaurants": [          {            "restaurantId": "22222222-2222-4222-8222-222222222222",            "restaurantName": "Fiest Sandbox Tampere",            "businessIdentity": {              "registeredName": "Fiest Sandbox Tampere Oy",              "businessId": "2345678-9"            }          }        ],        "restaurantsTruncated": false,        "authorizationCoverage": {          "authorizedRestaurantCount": 1,          "currentRestaurantCount": 1,          "additionalRestaurantCount": 0,          "reauthorizationAvailable": false        }      }    ],    "organizationCount": 2,    "authorizedRestaurantCount": 2  }}

Authorization

fiestOAuth fiest.restaurant.read, fiest.organization.read
headerAuthorizationBearer <token>

OAuth 2.1 authorization code with PKCE. Partner clients and redirect URIs must be approved by Fiest before use.

Scope: fiest.restaurant.read, fiest.organization.read

Response Body

The Management organizations and organization/restaurant associations currently covered by the authorization.

application/json
  1. response
data*