---
title: "List Gateway Integrations"
method: GET
path: "/gateway_integrations"
tags: ["Gateway Integrations"]
---

# List Gateway Integrations

`GET /gateway_integrations`

Retrieve a list of `Gateway Integration` resources.

## Query parameters

- `linked_to` string, required
- `after_cursor` string
- `before_cursor` string
- `created_at.gte` string, date-time
- `created_at.lte` string, date-time
- `limit` integer
- `tags.key` string
- `tags.value` string
- `updated_at.gte` string, date-time
- `updated_at.lte` string, date-time

## Headers

- `Finix-Version` string

## Response `200`

List of `Gateway Integration` resources

- object
  - `page` Page — Details the page that's returned.
    - `limit` integer — The number of entries to return.
    - `next_cursor` string, nullable — The cursor to use for the next page of results.
  - `_embedded` object
    - `gateway_integrations` GatewayIntegration[]
      - `id` string — The ID of the resource.
      - `created_at` string, date-time — Timestamp of when the object was created.
      - `updated_at` string, date-time — Timestamp of when the object was last updated.
      - `application_id` string — ID of the `Application` the resource was created under.
      - `linked_to` string — The ID of the `Merchant` to which the `Gateway Integration` is linked.
      - `linked_type` 'MERCHANT' — The type of resource to which the `Gateway Integration` is linked.
      - `email` string, email — The email address to receive the Cybersource dashboard invitation, which lets you retrieve your Cybersource transacting credentials. If this field was not provided, the invitation will be sent to the email address associated with the merchant's email address defined in [Identity](/api/identities) › `entity.email` field.
      - `state` 'FAILED' | 'PENDING' | 'SUCCEEDED' — The state of the `Gateway Integration`. The possible values are: - `PENDING`: The `Gateway Integration` is being processed. - `SUCCEEDED`: The `Gateway Integration` was successful. - `FAILED`: The `Gateway Integration` failed.
      - `tags` Tags, nullable — Include up to 50 `key: value` pairs to annotate requests with custom metadata. - Maximum character length for individual `keys` is 40. - Maximum character length for individual `values` is 500. (For example, `order_number: 25`, `item_type: produce`, `department: sales`)
      - `_links` object
        - `self` Self — Link to the resource that was used in the request.
          - `href` string
  - `_links` object
    - `self` Self — Link to the resource that was used in the request.
      - `href` string
    - `next` Next — Link to the next page of entries.
      - `href` string

## Other responses

- `401` — Unauthorized. Authentication is required and has failed or has not been provided.
- `403` — Forbidden. The client is authenticated but does not have permission to access the resource.
- `406` — Not Acceptable. The server could not accept the submitted request. Confirm how the request was formatted and submitted.
- `422` — Unprocessable Entity. The syntax of the request content was correct, but the server was unable to process the contained instructions.

---

[API](https://skmtc.net/finix/apis/finix-api-reference.md) · [All operations](https://skmtc.net/finix/apis/finix-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/finix/finix-api-reference/versions/5426f6f99c52/schema)