---
title: "Get vendor connection request status"
method: GET
path: "/v3/network/invitation/vendor/{vendorId}"
tags: ["network"]
---

# Get vendor connection request status

`GET /v3/network/invitation/vendor/{vendorId}`

## Request

- Base URL: `https://gateway.stage.bill.com/connect`
- URL: `https://gateway.stage.bill.com/connect/v3/network/invitation/vendor/{vendorId}`
- Auth: none declared

Get the status of an existing connection request sent with `POST /v3/network/invitation/vendor/{vendorId}`.

When you send a connection request to a vendor organization that has auto-connections enabled, BILL automatically connects you with the organization. If the organization has auto-connections disabled, the connection request status changes when the vendor accepts the request.

**Note**: If the vendor does not respond to the connection request for 60 days, the request expires.

See [BILL Network](https://developer.bill.com/docs/bill-network) in the Guides section for more information, sample requests, and responses.

## Path parameters

- `vendorId` string, required: BILL-generated ID of the vendor record in your organization. The value begins with `009`.

## Headers

- `sessionId` string, nullable: API session ID generated with `/v3/login`
- `devKey` string, nullable: Developer key generated with your BILL developer account

## Response `200`

Get vendor connection request status response

- GetInvitationResponseDto: Invitation status response.
  - `id` string: BILL-generated ID of the customer or vendor record in your organization
  - `status` 'NOT_CONNECTED' | 'PENDING' | 'CONNECTED' | 'CONNECTED_RPPS': Network invitation status.
  - `networkId` string: Payment Network ID (PNI). BILL uses the PNI to send and receive electronic payments.

## Other responses

- `4XX`: List of errors.
- `5XX`: List of errors.

---

[API](https://skmtc.dev/bill/apis/bill-v3-api.md) - [All operations](https://skmtc.dev/bill/apis/bill-v3-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bill/apis/bill-v3-api/revisions/54edddceb0a5?raw)