---
title: "Retrieve the current status of a broker integration"
method: GET
path: "/integration/brokerIntegrationStatus"
tags: ["integration"]
---

# Retrieve the current status of a broker integration

`GET /integration/brokerIntegrationStatus`

## Request

- Base URL: `https://demo-developer.convoy.com/broker`
- URL: `https://demo-developer.convoy.com/broker/integration/brokerIntegrationStatus`
- Auth: HTTP bearer

Retrieve the current status of a broker integration.

## Query parameters

- `integratorBrokerId` string, required

## Headers

- `X-Convoy-API-Version` string, required

## Response `200`

The request has succeeded.

- BrokerIntegrationBrokerIntegrationRequestStatusResponse
  - `status` 'PENDING' | 'CONFIRMED' | 'CANCELED' | 'VERIFICATION_FAILED' | 'ACTIVATED' | 'DEACTIVATED', required: The status of the broker integration request | Status | Description | | ------------------- |-------------| | PENDING | The integration request was created and is pending confirmation by a broker admin and broker account verification by Convoy. | | VERIFICATION_FAILED | The Convoy broker account did not pass the verification stage (failed one or more checks). | | CONFIRMED | The integration request was confirmed by a broker admin. The broker account is still pending verification by Convoy. | | CANCELED | The integration request was canceled. The broker may submit another integration request. | | ACTIVATED | The integration was approved by the broker and client credentials have been created for the integrator to use. | | DEACTIVATED | Convoy broker integration was deactivated. Any credentials associated with this broker integration cannot be used to access the Convoy API. |

## Other responses

- `400`: Invalid request.
- `default`: Unexpected error.

---

[API](https://skmtc.dev/convoy/apis/brokers.md) - [All operations](https://skmtc.dev/convoy/apis/brokers/llms.txt) - [OpenAPI document](https://skmtc.dev/convoy/apis/brokers/revisions/a43e2868b355?raw)