---
title: "Retrieve the status of the broker integration client credentials. This API may be used to check that the provided broker integration credentials are valid."
method: GET
path: "/integration/brokerIntegrationCredentialsStatus"
tags: ["integration"]
---

# Retrieve the status of the broker integration client credentials. This API may be used to check that the provided broker integration credentials are valid.

`GET /integration/brokerIntegrationCredentialsStatus`

## Request

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

Retrieve the status of the credentials for a broker integration. The status indicates whether the credentials are valid.

## Headers

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

## Response `200`

The request has succeeded.

- BrokerIntegrationBrokerIntegrationCredentialsStatusResponse: Retrieve broker integration credentials statusresponse.
  - `status` 'VALID', required: The status of the integration credentials. Invalid credentials will be expressed via HTTP response code 400.
  - `integratorBrokerId` string, required: The id of the integrator broker to which this credential is associated.

## 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)