---
updatedAt: 2026-04-21T09:29:18.000Z
agentTools:
  projectIndex: https://partner.getpliant.com/llms.txt
---

# List Organizations

Returns a list of organizations. You can filter by status or VAT ID to find specific organizations. You can use the `limit`, `page`, `sortBy` and `sortDirection` parameters to filter and sort the results.


# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "contact": {
      "name": "API Support",
      "email": "support@getpliant.com",
      "url": "https://www.getpliant.com"
    },
    "title": "Pliant Partner API",
    "description": "Pliant Partner API",
    "version": "2.1.0",
    "license": {
      "name": "MIT",
      "url": "https://opensource.org/license/MIT"
    }
  },
  "servers": [
    {
      "url": "https://partner-api.getpliant.com/api",
      "description": "Pliant Production Server"
    },
    {
      "url": "https://sandbox.partner-api.getpliant.com/api",
      "description": "Pliant Sandbox Server"
    },
    {
      "url": "https://pci-api.getpliant.com",
      "description": "PCI Vault Production Server"
    },
    {
      "url": "https://pci-sandbox.partner-api.getpliant.com",
      "description": "PCI Vault Sandbox Server"
    }
  ],
  "x-readme": {
    "explorer-enabled": false,
    "samples-languages": [
      "curl",
      "java",
      "kotlin"
    ],
    "headers": [
      {
        "key": "Pliant-API-Version",
        "value": "2.1.0"
      }
    ]
  },
  "tags": [
    {
      "name": "Organizations",
      "description": "This tag is for operations related to organizations"
    }
  ],
  "paths": {
    "/organizations": {
      "get": {
        "summary": "List Organizations",
        "description": "Returns a list of organizations. You can filter by status or VAT ID to find specific organizations. You can use the `limit`, `page`, `sortBy` and `sortDirection` parameters to filter and sort the results.\n",
        "tags": [
          "Organizations"
        ],
        "operationId": "list-organizations",
        "parameters": [
          {
            "name": "status",
            "in": "query",
            "description": "The status of the organizations to filter by.",
            "schema": {
              "$ref": "#/components/schemas/Organization/properties/status"
            }
          },
          {
            "name": "vatId",
            "in": "query",
            "description": "The VAT ID of the organization to filter by.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "The maximum number of items to return per page. The default value if not provided is 100, the maximum allowed value is 1000.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "page",
            "in": "query",
            "description": "The page number to return, starting with 0, this counts up to the total number of pages. The total number of pages is determined by the total number of records divided by the limit.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "sortBy",
            "in": "query",
            "description": "The field to sort by.",
            "schema": {
              "type": "string",
              "enum": [
                "id",
                "name",
                "status",
                "createdAt"
              ]
            }
          },
          {
            "name": "sortDirection",
            "in": "query",
            "description": "The direction to sort by.",
            "schema": {
              "type": "string",
              "enum": [
                "ASC",
                "DESC"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Ok",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Organization"
                      }
                    },
                    "hasNextPage": {
                      "type": "boolean",
                      "description": "Indicates whether there is a next page available."
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400"
          },
          "401": {
            "$ref": "#/components/responses/401"
          },
          "403": {
            "$ref": "#/components/responses/403"
          },
          "429": {
            "$ref": "#/components/responses/429"
          },
          "500": {
            "$ref": "#/components/responses/500"
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "description": "This API uses oAuth2 with client credentials flow to [obtain the Bearer Token](/docs/authenticated-api-usage).",
        "bearerFormat": "JWT"
      }
    },
    "schemas": {
      "Organization": {
        "type": "object",
        "properties": {
          "organizationId": {
            "type": "string",
            "format": "uuid",
            "description": "The id of the organization."
          },
          "name": {
            "type": "string",
            "description": "The name of the organization."
          },
          "status": {
            "type": "string",
            "description": "The status of the organization, see [our guides](/docs/organization-entity) for more details.",
            "enum": [
              "ONBOARDING_STARTED",
              "ONBOARDING_RISK_AND_COMPLIANCE",
              "ONBOARDING_MANDATES_AND_TERMS",
              "ACTIVE",
              "DEACTIVATED",
              "CANCELLED"
            ],
            "example": "ONBOARDING_STARTED"
          },
          "vatId": {
            "type": "string",
            "nullable": true,
            "description": "The VAT ID of the organization, if available."
          },
          "cardAccounts": {
            "type": "array",
            "description": "The [card accounts](/docs/card-account) of the organization. At least one card account is required.",
            "items": {
              "type": "object",
              "description": "A [card account](/docs/card-account) of the organization.",
              "properties": {
                "id": {
                  "type": "string",
                  "format": "uuid",
                  "description": "The id of the card account."
                },
                "name": {
                  "type": "string",
                  "description": "The name of the card account."
                },
                "status": {
                  "type": "string",
                  "description": "The status of the card account.",
                  "enum": [
                    "ACTIVE",
                    "PENDING",
                    "DEACTIVATED",
                    "CANCELLED"
                  ]
                },
                "defaultAccount": {
                  "type": "boolean",
                  "description": "Indicates whether this is the default card account. There is always one active default card account."
                }
              }
            }
          },
          "paymentProgramId": {
            "type": "string",
            "format": "uuid",
            "description": "The id of the payment program this organization belongs to."
          }
        }
      },
      "Error": {
        "type": "object",
        "properties": {
          "errorCode": {
            "type": "string",
            "description": "The error code"
          },
          "exceptionId": {
            "type": "string",
            "format": "uuid",
            "description": "The id of the exception that was thrown"
          },
          "message": {
            "type": "string",
            "description": "The cause of the error or further explanations on the error"
          }
        }
      }
    },
    "responses": {
      "400": {
        "description": "Bad Request. The API consumer sent a malformed request which could not be processed.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            }
          }
        }
      },
      "401": {
        "description": "Unauthorized. The API consumer is not authorized to access the requested resource.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            }
          }
        }
      },
      "403": {
        "description": "Forbidden. The API consumer is not allowed to access the requested resource.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            }
          }
        }
      },
      "429": {
        "description": "Too Many Requests. The API consumer has sent too many requests in a given amount of time. Please check our [API guidelines](/docs/pliant-api-guidelines#api-rate-limits).",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "error": {
                  "type": "string",
                  "description": "Detailed description of the error and breached rate limit."
                }
              }
            }
          }
        }
      },
      "500": {
        "description": "Internal Server Error. The request was not completed due to an internal error.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            }
          }
        }
      }
    }
  },
  "security": [
    {
      "bearerAuth": []
    }
  ]
}
```