---
title: "Fetch Interaction"
method: POST
path: "/journey/interaction/fetch"
tags: ["Interaction Service"]
---

# Fetch Interaction

`POST /journey/interaction/fetch`

## Request

- Base URL: `https://eu.platform.go.gbgplc.com/v2/captain`
- URL: `https://eu.platform.go.gbgplc.com/v2/captain/journey/interaction/fetch`
- Auth: HTTP bearer

Fetch Interaction

## Request body

- object
  - `instanceId` string, required: Journey instance identifier

## Response `200`

Success

- union
  - object
    - `instanceId` string, required: Journey instance identifier
    - `interactionId` string, required: Interaction identifier
    - `journey` object, required
      - `status` 'Completed' | 'InProgress' | 'Failed' | 'Paused', required
    - `interaction` object, required
      - `resource` object
        - `id` string, required
        - `name` string, required
        - `hash` string
        - `version` string
        - `type` 'brand' | 'delivery' | 'flow' | 'form' | 'i18n' | 'journey' | 'license' | 'model' | 'organization' | 'template' | 'interaction'
        - `data` object
          - `pages` object[], required
            - `id` string, required
            - `label` string
            - `cards` object[], required
              - …
      - `collects` union[], required
        - union
          - object
            - `ref` string, required
            - `spec` 'required' | 'optional' | 'conditional', required
            - `recommended` boolean
          - object
            - `ref` string, required
            - `spec` 'required' | 'optional' | 'conditional', required
            - `recommended` boolean
            - `combinator` 'oneOf' | 'allOf', required
            - `inputs` object[], required
              - …
      - `consumes` union[], required
        - union
          - object
            - `ref` string, required
            - `spec` 'required' | 'optional' | 'conditional', required
            - `recommended` boolean
          - object
            - `ref` string, required
            - `spec` 'required' | 'optional' | 'conditional', required
            - `recommended` boolean
            - `combinator` 'oneOf' | 'allOf', required
            - `inputs` object[], required
              - …
      - `grId` string, required
    - `context` object
      - `subject` object
        - `identity` object
          - `title` string: Title of an individual such as Mr, Mrs, Dr, Sir
          - `firstName` string: A person's name used by their collegues and friends to address them
          - `middleNames` string[]: Any other registered names used by the individual, not aliases
          - `lastNames` string[]: Any family names for the individual
          - `lastNamesAtBirth` string[]: Any family names for the individual
          - `aliases` object[]
            - `title` string: Title of an individual such as Mr, Mrs, Dr, Sir
            - `firstName` string: A person's name used by their collegues and friends to address them
            - `middleNames` string[]: Any other registered names used by the individual, not aliases
            - `lastNames` string[]: Any family names for the individual
            - `lastNamesAtBirth` string[]: Any family names for the individual
          - `relatedPersons` object[]
            - `title` string: Title of an individual such as Mr, Mrs, Dr, Sir
            - `firstName` string: A person's name used by their collegues and friends to address them
            - `middleNames` string[]: Any other registered names used by the individual, not aliases
            - `lastNames` string[]: Any family names for the individual
            - `lastNamesAtBirth` string[]: Any family names for the individual
            - `relationship` 'mother' | 'father' | 'maternalGrandFather' | 'maternalGrandMother' | 'paternalGrandFather' | 'paternalGrandMother', required
          - `dateOfBirth` string: Specified in year, month and day separated by -. For example 2017-1-1 or 2017-01-01 which conforms to ISO 8601
          - `gender` string
          - `currentAddress` object
            - `lines` string[]: Unformatted line based address
            - `addressString` string: The address as a single line
            - `premise` string: The primary delivery point for a premise or building. This could be a house number, a building name, etc.
            - `building` string: The name of a building or a building complex. In the US, this is the street number.
            - `subBuilding` string: The name of a sub-building, such as a flat or apartment number.
            - `thoroughfare` string: This field holds the most common street or block data element within a country. For instance, USA Street
            - `dependentThoroughfare` string: The name of a dependent street or block, such as a street within a complex.
            - `locality` string: This field holds the most common population center data element within a country. For instance, USA City, Canadian Municipality
            - `dependentLocality` string: This is a smaller area within a locality, such as a neighborhood or district. Like Manhattan in New York City, or Soho in London.
            - `doubleDependentLocality` string: This is an even smaller area within a dependent locality, often used in very detailed addresses.
            - `postalCode` string: This field contains the complete postal code for a particular delivery point, should such detail be able to be determined. For example ZIP code in the US
            - `postBox` string: This field contains the post box number associated with a particular delivery point, should one exist.
            - `country` string: Country the address is in. It must be a valid ISO2 or ISO3 country code
            - `superAdministrativeArea` string
            - `administrativeArea` string
            - `subAdministrativeArea` string
            - `organization` string
            - `location` object
              - …
          - `previousAddresses` object[]
            - `lines` string[]: Unformatted line based address
            - `addressString` string: The address as a single line
            - `premise` string: The primary delivery point for a premise or building. This could be a house number, a building name, etc.
            - `building` string: The name of a building or a building complex. In the US, this is the street number.
            - `subBuilding` string: The name of a sub-building, such as a flat or apartment number.
            - `thoroughfare` string: This field holds the most common street or block data element within a country. For instance, USA Street
            - `dependentThoroughfare` string: The name of a dependent street or block, such as a street within a complex.
            - `locality` string: This field holds the most common population center data element within a country. For instance, USA City, Canadian Municipality
            - `dependentLocality` string: This is a smaller area within a locality, such as a neighborhood or district. Like Manhattan in New York City, or Soho in London.
            - `doubleDependentLocality` string: This is an even smaller area within a dependent locality, often used in very detailed addresses.
            - `postalCode` string: This field contains the complete postal code for a particular delivery point, should such detail be able to be determined. For example ZIP code in the US
            - `postBox` string: This field contains the post box number associated with a particular delivery point, should one exist.
            - `country` string: Country the address is in. It must be a valid ISO2 or ISO3 country code
            - `superAdministrativeArea` string
            - `administrativeArea` string
            - `subAdministrativeArea` string
            - `organization` string
            - `location` object
              - …
            - `fromDate` string, required: Specified in year, month and day separated by -. For example 2017-1-1 or 2017-01-01 which conforms to ISO 8601
            - `toDate` string, required: Specified in year, month and day separated by -. For example 2017-1-1 or 2017-01-01 which conforms to ISO 8601
          - `placeOfBirth` object
            - `lines` string[]: Unformatted line based address
            - `addressString` string: The address as a single line
            - `premise` string: The primary delivery point for a premise or building. This could be a house number, a building name, etc.
            - `building` string: The name of a building or a building complex. In the US, this is the street number.
            - `subBuilding` string: The name of a sub-building, such as a flat or apartment number.
            - `thoroughfare` string: This field holds the most common street or block data element within a country. For instance, USA Street
            - `dependentThoroughfare` string: The name of a dependent street or block, such as a street within a complex.
            - `locality` string: This field holds the most common population center data element within a country. For instance, USA City, Canadian Municipality
            - `dependentLocality` string: This is a smaller area within a locality, such as a neighborhood or district. Like Manhattan in New York City, or Soho in London.
            - `doubleDependentLocality` string: This is an even smaller area within a dependent locality, often used in very detailed addresses.
            - `postalCode` string: This field contains the complete postal code for a particular delivery point, should such detail be able to be determined. For example ZIP code in the US
            - `postBox` string: This field contains the post box number associated with a particular delivery point, should one exist.
            - `country` string: Country the address is in. It must be a valid ISO2 or ISO3 country code
            - `superAdministrativeArea` string
            - `administrativeArea` string
            - `subAdministrativeArea` string
            - `organization` string
            - `location` object
              - …
          - `idNumbers` object[]
            - `type` string, required: The type of phone number, such as landline, mobile, fax, unknown etc
            - `idNumber` string, required: ID number eg, National Insurance Number in UK, Social Securtiy Number in US
            - `country` string: Country the address is in. It must be a valid ISO2 or ISO3 country code
          - `phones` object[]
            - `type` string, required: The type of phone number, such as landline, mobile, fax, unknown etc
            - `number` string, required: Phone number, ideally in international format with +(Country Code)
          - `emails` object[]
            - `type` string, required: The type of email, such as home, work, unknown etc
            - `email` string, required: Email address
          - `socials` object[]
            - `type` string, required: An agreed standardised name for the social media platform this identity relates to such as Facebook, Twitter, unknown etc
            - `identity` string, required: the identity used on this platform
          - `mothersMaidenName` string: The subject's mother's maiden name, used for identity verification
        - `documents` object[]
          - `oneDBarcode` string
          - `address` object
            - `addressString` string
            - `extractedAddressString` string
            - `addressLine1` string
            - `addressLine2` string
            - `locality` string
            - `administrativeArea` string
            - `postalCode` string
          - `applicationDate` string
          - `applicationNumber` string
          - `dateOfBirth` string
          - `placeOfBirth` string
          - `placeOfBirthNative` string
          - `bloodType` string
          - `controlNumber` string
          - `countryCode` string
          - `countryName` string
          - `documentClassCode` string
          - `documentClassName` string
          - `documentNumber` string
          - `documentSignerCertificate` string
          - `employer` string
          - `employerAddress` string
          - `entries` string
          - `expirationDate` string
          - `eyeColor` string
          - `fathersName` string
          - `fathersNameNative` string
          - `fathersSurname` string
          - `firstName` string
          - `fullName` string
          - `fullNameNative` string
          - `givenName` string
          - `givenNameNative` string
          - `hairColor` string
          - `height` string
          - `issueDate` string: Specified in year, month and day separated by -. For example 2017-1-1 or 2017-01-01 which conforms to ISO 8601
          - `issuingAuthority` string
          - `issuingAuthorityNative` string
          - `issuingStateCode` string
          - `issuingStateName` string
          - `licenseClass` string
          - `licenseEndorsements` string
          - `licenseRestrictions` string
          - `mrz` string
          - `mrz1` string
          - `mrz2` string
          - `mrz3` string
          - `middleName` string
          - `mothersName` string
          - `mothersNameNative` string
          - `mothersSurname` string
          - `nameSuffix` string
          - `nationalityCode` string
          - `nationalityName` string
          - `nationalityNameNative` string
          - `occupation` string
          - `organDonor` boolean
          - `passportNumber` string
          - `permitNumber` string
          - `personalNumber` string
          - `photo` string
          - `photoCompressed` string
          - `photoEncoding` string
          - `sex` string
          - `sexNative` string
          - `signature` string
          - `signatureCompressed` string
          - `signatureEncoding` string
          - `socialSecurityNumber` string
          - `startDate` string
          - `surname` string
          - `surnameNative` string
          - `visaClass` string
          - `visaNumber` string
          - `weight` string
          - `cardNumber` string
          - `issuerCountryCode` string: Country the address is in. It must be a valid ISO2 or ISO3 country code
          - `id` string
          - `type` string
          - `category` string
          - `subtype` string
          - `format` string
          - `device` object
            - `type` string
            - `model` string
            - `hasContactlessReader` boolean
            - `hasMagneticStripeReader` boolean
            - `hasCamera` boolean
            - `serialNumber` string
            - `manufacturer` string
          - `side1Image` string
          - `side2Image` string
          - `chip` object
            - `lds` object[], required
              - …
            - `auth` object[], required
              - …
          - `classification` object
            - `ids` string[]
            - `category` string
            - `type` string
            - `subtype` string
            - `isDoubleSided` boolean
            - `hasNFC` boolean
            - `year` string
            - `countryCode` string
            - `countryName` string
            - `stateCode` string
            - `stateName` string
            - `sides` object[]
              - …
          - `extraction` object
            - `aggregatedFields` object[]
              - …
            - `extractedFields` object[]
              - …
            - `extractedImages` object[]
              - …
          - `validation` object
            - `validationChecks` object[]
              - …
            - `aggregatedValidationChecks` object[]
              - …
          - `subType` string
          - `number` string
          - `expiryDate` string: Specified in year, month and day separated by -. For example 2017-1-1 or 2017-01-01 which conforms to ISO 8601
          - `subject` object
            - `title` string: Title of an individual such as Mr, Mrs, Dr, Sir
            - `firstName` string: A person's name used by their collegues and friends to address them
            - `middleNames` string[]: Any other registered names used by the individual, not aliases
            - `lastNames` string[]: Any family names for the individual
            - `lastNamesAtBirth` string[]: Any family names for the individual
            - `aliases` object[]
              - …
            - `relatedPersons` object[]
              - …
            - `dateOfBirth` string: Specified in year, month and day separated by -. For example 2017-1-1 or 2017-01-01 which conforms to ISO 8601
            - `gender` string
            - `currentAddress` object
              - …
            - `previousAddresses` object[]
              - …
            - `placeOfBirth` object
              - …
            - `idNumbers` object[]
              - …
            - `phones` object[]
              - …
            - `emails` object[]
              - …
            - `socials` object[]
              - …
            - `mothersMaidenName` string: The subject's mother's maiden name, used for identity verification
          - `country` string: Country the address is in. It must be a valid ISO2 or ISO3 country code
        - `biometrics` union[]
          - union
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
        - `sessions` object[]
          - `user` object
            - `id` string, required
            - `email` string, email, required
            - `domain` string, required
          - `client` object
            - `id` string, required
            - `ip` string, required
            - `address` string, required
          - `device` object
            - `id` string, required
            - `manufacturer` string, required
            - `model` object, required
              - …
          - `trace` object
            - `id` string, required
          - `span` object
            - `id` string, required
          - `transaction` object
            - `id` string, required
          - `auth` object[]
            - `id` string, required
            - `scope` string
            - `codeVerifier` string
            - `code` string
            - `state` string
            - `redirectUri` string
            - `responseType` string
            - `clientId` string
            - `clientSecret` string
        - `consent` object[]
          - `type` 'rollup' | 'explicit' | 'implicit'
          - `id` string
          - `version` string
          - `url` string, uri, required
          - `effectiveDate` string
          - `expiryDate` string
          - `terms` string
          - `purpose` string
          - `legalBasis` string
          - `jurisdiction` string
          - `subject` string
          - `signatory` string
        - `accounts` object[]
          - `type` string, required: The type of account, e.g. Bank Account, Building Society
          - `accountNumber` string, required: Account number
          - `sortCode` string: UK sort code
          - `routingNumber` string: US ABA routing number
          - `iban` string: International Bank Account Number
          - `bic` string: BIC/SWIFT code
          - `accountHolderName` string: Name on the account
          - `bankName` string: Name of the financial institution
          - `country` string: Country the address is in. It must be a valid ISO2 or ISO3 country code
          - `accountType` string: Account classification, e.g. current, savings
        - `uid` string
    - `instructions` string[]
    - `outstanding` string[]
  - object
    - `status` 'error', required
    - `code` number, required: Error code indicating the type of error
    - `message` string, required: Error message detailing the issue
  - object
    - `instanceId` string, required: Journey instance identifier
    - `journey` object, required
      - `status` 'Completed' | 'InProgress' | 'Failed' | 'Paused', required
    - `processing` boolean: True when the journey is still working and no interaction is available yet. Clients should poll /journey/interaction/fetch until this is absent/false and an `interaction` is returned.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `405`: Method Not Allowed
- `500`: Internal Server Error
- `503`: Service Unavailable

## Changes

- **2026-07-06** `38056a3470d6`: 1 breaking
  - the response property `anyOf[subschema #3]/processing` became optional for the status `200`
- **2026-07-06** `2841983b254a`: 1 info
  - added `subschema #3` to the response body `anyOf` list for the response status `200`
- **2026-03-02** `26d99191e88d`: 4 warning, 1 info
  - added the new `allOf` enum value to the `anyOf[subschema #1]/interaction/collects/items/anyOf[subschema #2]/combinator` response property for the response status `200`
  - added the new `allOf` enum value to the `anyOf[subschema #1]/interaction/consumes/items/anyOf[subschema #2]/combinator` response property for the response status `200`
  - added the new `oneOf` enum value to the `anyOf[subschema #1]/interaction/collects/items/anyOf[subschema #2]/combinator` response property for the response status `200`
  - added the new `oneOf` enum value to the `anyOf[subschema #1]/interaction/consumes/items/anyOf[subschema #2]/combinator` response property for the response status `200`
  - …1 more
- **2026-02-13** `7721a2651633`: 1 breaking
  - the response property `anyOf[subschema #1]/context` became optional for the status `200`

[Operation history](https://skmtc.dev/gbgplc/apis/gbg-go-next-gen-flow-captain-api/changes/journey/interaction/fetch/post.md)

---

[API](https://skmtc.dev/gbgplc/apis/gbg-go-next-gen-flow-captain-api.md) - [All operations](https://skmtc.dev/gbgplc/apis/gbg-go-next-gen-flow-captain-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gbgplc/apis/gbg-go-next-gen-flow-captain-api/revisions/f4b64916866a?raw)