---
title: "Get corporation"
method: GET
path: "/api/v1/corporations"
tags: ["Corporations"]
---

# Get corporation

`GET /api/v1/corporations`

## Request

- Base URL: `https://api-business.wirexapp.com`
- URL: `https://api-business.wirexapp.com/api/v1/corporations`
- Auth: API key in header `Authorization`

Retrieves corporation details that were provided during registration/KYB, along with its status, verification status and wallet status.

## Request body `*/*`

- RequestEmptyRequest

## Response `200`

OK

- ResponseCorporationResponse
  - `actions` ResponseCorporationAction[], required: Actions that are allowed for this corporation
    - `relative_path` string, required: Relative path of the API that executes this action
    - `type` 'IssuePlasticCard' | 'IssueVirtualCard' | 'Verify' | 'ReceiveSepaTransfer' | 'SendSepaTransfer' | 'ActivateSepaDetails' | 'SendAchTransfer' | 'ReceiveAchDeposit' | 'ActivateAchDetails' | 'SendSpeiTransfer' | 'ReceiveSpeiDeposit' | 'ActivateSpeiDetails', required
  - `capabilities` ResponseCapability[], required: Capabilities that are available for this corporation
    - `prerequisites` ResponseCapabilityType[], required: Capabilities that should be activated before this capability can be used
    - `status` 'Active' | 'ActivationNotStarted' | 'InProgress' | 'NotFulfilled' | 'NotRequired' | 'NotAvailable', required
    - `status_reason` string: Reason for the capability status. May be empty or may contain a message explaining the status
    - `type` 'SepaAccount' | 'SepaIn1stParty' | 'SepaIn3rdParty' | 'SepaOut1stParty' | 'SepaOut3rdParty' | 'AchAccount' | 'AchIn1stParty' | 'AchIn3rdParty' | 'AchOut1stParty' | 'AchOut3rdParty' | 'SpeiAccount' | 'SpeiIn1stParty' | 'SpeiIn3rdParty' | 'SpeiOut1stParty' | 'SpeiOut3rdParty' | 'FasterPaymentsAccount' | 'FasterPaymentsIn1stParty' | 'FasterPaymentsIn3rdParty' | 'FasterPaymentsOut1stParty' | 'FasterPaymentsOut3rdParty' | 'VisaPlasticCard' | 'VisaVirtualCard' | 'CardTransfer' | 'CpnExternalProfile' | 'PixOut3rdParty' | 'FpsHkOut3rdParty' | 'FedwireOut3rdParty' | 'SwiftOut3rdParty' | 'CipsOut3rdParty' | 'ChatsOut3rdParty' | 'TripleAExternalProfile' | 'ImpsOut3rdParty' | 'InstapayOut3rdParty' | 'BiFastOut3rdParty' | 'NipOut3rdParty' | 'IppOut3rdParty' | 'PseOut3rdParty' | 'FxTransfer' | 'StableExchange', required
    - `verification_requirements` ResponseVerificationLevelRequirement[], required: Verification levels required to use this capability
      - `order` integer, required: Order of the verification level in the list
      - `type` 'N/A' | 'SDD' | 'EDD' | 'XDDBridgeBase' | 'XDDOpenPaydBase', required
  - `corporation_address` string, required: Address of account abstraction registered as corporation main wallet
  - `corporation_contact_details` ResponseCorporationContactDetails, required
    - `email` string, required: Email of the contact person
    - `name` string, required: Name of the contact person
    - `phone_number` string, required: Phone number of the contact person
  - `corporation_id` string, required: Id of the corporation in Wirex internal system
  - `corporation_name` string, required: Registered name of the corporation
  - `corporation_registration_address` ResponseRegistrationAddress, required
    - `city` string, required: City of the address
    - `country` string, required: Country of the address
    - `line1` string, required: Line 1 of unstructured address
    - `line2` string: Line 2 of unstructured address, empty when the address has no second line
    - `postal_code` string, required: Postal code of the address
    - `state` string: State of the address, empty in countries with no state or province subdivision
  - `corporation_type` 'None' | 'LimitedLiability' | 'SoleTrader' | 'Partnership' | 'PublicLimitedCompany' | 'JointStockCompany' | 'Charity', required
  - `freshdesk_id` string, required: Id that can be used to restore freshdesk chats
  - `owner_address` string, required: Address of the owner of the corporation
  - `passed_levels` ResponseVerificationLevel[], required: Verification levels that were passed by the corporation (This field is obsolete and will be removed in future releases, use VerificationLevels instead)
  - `registration_number` string, required: Registration number of the corporation
  - `short_id` string: Short id of the corporation. Set at registration but not yet exposed on the read path: service-corporation's CorporationInfoModel does not carry it, so this endpoint omits it until it does.
  - `status` 'None' | 'Pending' | 'Active' | 'Blocked' | 'Deleted', required
  - `status_reason` string: Reason for the status
  - `verification_levels` ResponseVerificationLevelData[], required: Verification levels that corporation applied to
    - `level` 'N/A' | 'SDD' | 'EDD' | 'XDDBridgeBase' | 'XDDOpenPaydBase', required
    - `status` 'None' | 'Pending' | 'Applied' | 'InReview' | 'Approved' | 'Rejected' | 'Canceled', required
  - `verification_status` 'None' | 'Pending' | 'Applied' | 'InReview' | 'Approved' | 'Rejected' | 'Canceled', required

## Other responses

- `400`: Bad Request
- `500`: Internal Server Error

---

[API](https://skmtc.dev/wirexapp/apis/wirex-corporate-baas-api.md) - [All operations](https://skmtc.dev/wirexapp/apis/wirex-corporate-baas-api/llms.txt) - [OpenAPI document](https://skmtc.dev/wirexapp/apis/wirex-corporate-baas-api/revisions/6525bfbc8f99?raw)