---
title: "List"
method: GET
path: "/configs"
---

# List

`GET /configs`

## Request

- Base URL: `https://api.traversal.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.traversal.com/configs`
- Auth: none declared

Get list of available configurations based on RBAC roles.

Permissions: org member, org setup user, or org admin. Platform admins
see every organization; everyone else sees only their own. All callers
get their current organization in the response.

Setup users sit outside the member hierarchy, but the app shell still
needs this payload to configure integrations.

## Response `200`

Successful Response

- ListConfigsResponse: Response model for listing available configurations. Used by the /configs endpoint to return organization configs based on user RBAC roles.
  - `organizations` OrganizationWithConfig[], required
    - `config_name` string, required
    - `organization_id` string, required
    - `organization_name` string, required
    - `organization_display_name` string, nullable
    - `organization_auth_provider` string, nullable
    - `organization_identifier` string, nullable
    - `organization_auth0_id` string, nullable
    - `organization_is_invite_only` boolean
    - `metadata` object, nullable
    - `logo_url` string, nullable
  - `configs` string[], required
  - `current_organization` OrganizationWithConfig, required: Organization information with full configuration details.
    - `config_name` string, required
    - `organization_id` string, required
    - `organization_name` string, required
    - `organization_display_name` string, nullable
    - `organization_auth_provider` string, nullable
    - `organization_identifier` string, nullable
    - `organization_auth0_id` string, nullable
    - `organization_is_invite_only` boolean
    - `metadata` object, nullable
    - `logo_url` string, nullable
  - `legal_agreement` LegalAgreementStatus, required: The caller's organization's click-through legal agreement status.
    - `required` boolean, required
    - `can_sign` boolean, required
    - `version` string, nullable, required
    - `signed_at` string, date-time, nullable, required

## Changes

> 66 revisions in range; 9 not diffed.

- **2026-09-29** `c939e4d80cd7`: 1 info
  - added the required property `legal_agreement` to the response with the `200` status

[Operation history](https://skmtc.dev/traversal/apis/traversal-api/changes/configs/get.md)

---

[API](https://skmtc.dev/traversal/apis/traversal-api.md) - [All operations](https://skmtc.dev/traversal/apis/traversal-api/llms.txt) - [OpenAPI document](https://skmtc.dev/traversal/apis/traversal-api/revisions/31e1a8b7cf89?raw)