# Retrieve an Integration

Retrieve details of a specific integration.

Endpoint: GET /v1/integrations/{id}
Version: 1.0.0-beta.27
Security: ApiKeyAuth

## Security:

  - `ApiKeyAuth` (unknown)
    apiKey in header Api-Key

## Path parameters:

  - `id` (string, required)

## Header parameters:

  - `Client-Id` (string, required)

  - `X-Acting-As-Client-Id` (string)
    The child client this request acts on behalf of. A reseller still authenticates as itself — `Api-Key` and `Client-Id` stay the reseller's — and names the child here.

This works only from a parent to its own children. Merchants have no children, so a merchant calling as itself omits the header. Sending your own client ULID here is not the same as omitting it, and is rejected on some operations.

## Response 200:

  - `200` (unknown)
    Integration retrieved successfully

## Response 200 fields (application/json):

  - `id` (string | null)
    Unique identifier for this integration configuration.

  - `is_active` (boolean, required)
    Whether the integration is currently active.

  - `client` (string | null)
    The client ID associated with this integration.

  - `processor` (string, required)
    The payment processor or service provider for the integration. Send the value exactly as spelled here. On the integration operations the gateway parses this field case-sensitively, so `TSYS` is rejected.
    Enum: "Tsys", "Vericheck"

  - `integration_details` (object, required)
    Processor-specific integration details returned in responses. Shape varies by processor.

  - `integration_details.created_by` (integer | null)
    Internal ID of the user who created this integration.

  - `integration_details.created_at` (string | null)
    ISO 8601 timestamp of when the integration was created.

  - `integration_details.modified_by` (integer | null)
    Internal ID of the user who last modified this integration.

  - `integration_details.modified_at` (string | null)
    ISO 8601 timestamp of the last modification to this integration.

  - `integration_details.name` (string | null)
    Merchant legal name as registered with TSYS.

  - `integration_details.dba` (string | null)
    Doing Business As (DBA) name.

  - `integration_details.url` (string | null)
    Merchant website URL.

  - `integration_details.phone_number` (integer)
    Merchant contact phone number, as digits only. `TsysHostDetailsResponse` returns this as a 64-bit integer, so it carries no punctuation and no leading `+`.

  - `integration_details.fax_number` (string | null)
    Merchant fax number.

  - `integration_details.mid` (string | null)
    Merchant ID (MID) assigned by the payment processor.

  - `integration_details.amex_number` (string | null)
    American Express identification number for the merchant.

  - `integration_details.association` (string | null)
    Association or network identifier for the merchant.

  - `integration_details.bin` (string | null)
    Bank Identification Number (BIN) for the acquiring bank.

  - `integration_details.discover_number` (string | null)
    Discover network identifier for the merchant.

  - `integration_details.mcc` (string | null)
    Merchant Category Code (MCC) classifying the business type.

  - `integration_details.bank_number` (string | null)
    Acquiring bank number assigned by TSYS.

  - `integration_details.industry` (string | null)
    Industry type identifier for the merchant.

  - `integration_details.amex_opt_blue` (boolean | null)
    Whether the merchant participates in the American Express OptBlue program.

  - `integration_details.agent_chain` (string | null)
    Agent chain identifier associated with the merchant.

  - `integration_details.store_number` (string | null)
    Store number for the merchant location.

  - `integration_details.mvv` (string | null)
    Merchant Verification Value for the merchant's POS system.

  - `integration_details.terminal_number` (string | null)
    Terminal number associated with the merchant account.

  - `integration_details.agent_bank_number` (string | null)
    Agent bank number assigned by TSYS.

  - `integration_details.agent_chain_number` (string | null)
    Agent chain number assigned by TSYS.

  - `integration_details.descriptor_postal` (string | null)
    ZIP code on the cardholder's billing statement descriptor.

  - `integration_details.descriptor_city` (string | null)
    City on the cardholder's billing statement descriptor.

  - `integration_details.descriptor_state` (string | null)
    State on the cardholder's billing statement descriptor.

  - `integration_details.descriptor_country` (string | null)
    Country on the cardholder's billing statement descriptor.

  - `integration_details.descriptor_phone` (integer | null)
    Phone number shown on the cardholder's billing statement descriptor, as digits only. `TsysHostDetailsResponse` returns this as a nullable 64-bit integer, so it carries no punctuation and no leading `+`.

  - `integration_details.descriptor_store_number` (string | null)
    Store number on the cardholder's billing statement descriptor.

  - `integration_details.address1` (string | null)
    Primary street address of the merchant.

  - `integration_details.address2` (string | null)
    Secondary address line of the merchant.

  - `integration_details.descriptor_line3` (string | null)
    Third line of the billing statement descriptor.

  - `integration_details.terminal_id` (string | null)
    Terminal ID for the merchant's POS device.

  - `integration_details.v_number` (string | null)
    Visa-assigned number for the merchant.

  - `integration_details.settlement_time` (string | null)
    Daily batch settlement time in HH:MM format.

  - `integration_details.merchant_area_code` (integer, required)
    Area code of the merchant's primary phone number.

  - `integration_details.descriptor_area_code` (integer | null)
    Area code on the cardholder's billing statement descriptor.

  - `integration_details.sharing_group` (string | null)
    Visa-assigned sharing group identifier for direct debit and EBT network access.

  - `integration_details.merchant_aba_number` (string | null)
    Merchant's ABA routing number for settlement.

  - `integration_details.merchant_settlement_agent_number` (string | null)
    Settlement agent number for the merchant.

  - `integration_details.reimbursement_attribute` (string | null)
    Reimbursement attribute code for interchange qualification.

  - `integration_details.fcsid` (string | null)
    FCS ID — internal identifier for the merchant configuration.

  - `integration_details.metadata` (object | null)
    Key-value pairs for storing additional information on the transaction. Send `null` to clear all metadata.
At most 50 keys. Keys may contain letters, digits, hyphens, and underscores, up to 40 characters. Values are strings up to 500 characters. Every limit below is enforced; a request that exceeds any of them is rejected.

  - `integration_details.client_id` (string, required)
    Merchant's Client Id provided by Vericheck for API authentication.

  - `integration_details.client_secret` (string)
    Merchant's secret at Vericheck, returned masked. The real value is write-only — send it on the request and do not expect to read it back.

  - `correlation_id` (string)
    Identifier the gateway assigns to the request and carries across the services that handled it. Quote it when reporting a problem.

## Response 200 headers (application/json):

  - `x-request-id` (string, required)
    Unique identifier assigned to the request by the API server. Returned on every response, including errors. Log this value and supply it when contacting support so that a specific request can be traced.

## Response 400:

  - `400` (unknown)
    Bad request

## Response 400 fields (application/json):

  - `error_code` (string)
    The Gateway generated error code.

  - `error_message` (string)
    Human-readable explanation that is specific to this occurrence of the problem.

  - `details` (object | null)
    The field in the request that caused the error. May be null  if not applicable.

  - `source` (object | null)
    Object containing host-processor-specific error information.  May be null if not applicable.

  - `source.system` (string | null)
    The host processor name.

  - `source.code` (string | null)
    The host processor code.

  - `source.message` (string | null)
    The host processor message.

## Response 400 headers (application/json):

  - `x-request-id` (string, required)
    Unique identifier assigned to the request by the API server. Returned on every response, including errors. Log this value and supply it when contacting support so that a specific request can be traced.

## Response 401:

  - `401` (unknown)
    Not authenticated

## Response 401 fields (application/json):

  - `error_code` (string)
    The Gateway generated error code.

  - `error_message` (string)
    Human-readable explanation that is specific to this occurrence of the problem.

  - `details` (object | null)
    The field in the request that caused the error. May be null  if not applicable.

  - `source` (object | null)
    Object containing host-processor-specific error information.  May be null if not applicable.

  - `source.system` (string | null)
    The host processor name.

  - `source.code` (string | null)
    The host processor code.

  - `source.message` (string | null)
    The host processor message.

## Response 401 headers (application/json):

  - `x-request-id` (string, required)
    Unique identifier assigned to the request by the API server. Returned on every response, including errors. Log this value and supply it when contacting support so that a specific request can be traced.

## Response 403:

  - `403` (unknown)
    Forbidden

## Response 403 fields (application/json):

  - `error_code` (string)
    The Gateway generated error code.

  - `error_message` (string)
    Human-readable explanation that is specific to this occurrence of the problem.

  - `details` (object | null)
    The field in the request that caused the error. May be null  if not applicable.

  - `source` (object | null)
    Object containing host-processor-specific error information.  May be null if not applicable.

  - `source.system` (string | null)
    The host processor name.

  - `source.code` (string | null)
    The host processor code.

  - `source.message` (string | null)
    The host processor message.

## Response 403 headers (application/json):

  - `x-request-id` (string, required)
    Unique identifier assigned to the request by the API server. Returned on every response, including errors. Log this value and supply it when contacting support so that a specific request can be traced.

## Response 404:

  - `404` (unknown)
    Not Found

## Response 404 fields (application/json):

  - `error_code` (string)
    The Gateway generated error code.

  - `error_message` (string)
    Human-readable explanation that is specific to this occurrence of the problem.

  - `details` (object | null)
    The field in the request that caused the error. May be null  if not applicable.

  - `source` (object | null)
    Object containing host-processor-specific error information.  May be null if not applicable.

  - `source.system` (string | null)
    The host processor name.

  - `source.code` (string | null)
    The host processor code.

  - `source.message` (string | null)
    The host processor message.

## Response 404 headers (application/json):

  - `x-request-id` (string, required)
    Unique identifier assigned to the request by the API server. Returned on every response, including errors. Log this value and supply it when contacting support so that a specific request can be traced.

## Response 500:

  - `500` (unknown)
    Internal server error

## Response 500 fields (application/json):

  - `error_code` (string)
    The Gateway generated error code.

  - `error_message` (string)
    Human-readable explanation that is specific to this occurrence of the problem.

  - `details` (object | null)
    The field in the request that caused the error. May be null  if not applicable.

  - `source` (object | null)
    Object containing host-processor-specific error information.  May be null if not applicable.

  - `source.system` (string | null)
    The host processor name.

  - `source.code` (string | null)
    The host processor code.

  - `source.message` (string | null)
    The host processor message.

## Response 500 headers (application/json):

  - `x-request-id` (string, required)
    Unique identifier assigned to the request by the API server. Returned on every response, including errors. Log this value and supply it when contacting support so that a specific request can be traced.

## Response 400 examples:

  - `Invalid field value in the request body` (unknown)

## Response 401 examples:

  - `Missing or invalid API key` (unknown)

## Response 403 examples:

  - `Authenticated but not authorized for this action` (unknown)

## Response 404 examples:

  - `Resource ID does not exist` (unknown)

## Response 500 examples:

  - `Unhandled server fault or downstream processor error` (unknown)