> For the complete documentation index, see [llms.txt](https://apidocs.arionbanki.is/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://apidocs.arionbanki.is/business-apis/cards-api/cards-api-reference-1.md).

# Cards API Reference

Below is a documentation of the Cards API, note the urls are connected to the live environment. Change them to sandbox if you're working on that environment.

<a href="https://openapi.gitbook.com/o/0A1P6YvuPxpINWkYJpBX/spec/new-BAPI-Cards.yaml" class="button primary" data-icon="circle-arrow-down">Download Open API yaml file</a>

## Read list of cards.

> Reads a list of cards potentially with additional information, e.g. balance information.  It is assumed that a consent of the user to this access is already given and stored on the Bank's system. The addressed list of cards depends then on the stored consent addressed by consentId, respectively the OAuth2 access token.  Please note, that the current line of credit of a given card might be tighter than what the balance response will suggest, due to credit limits on the card account and transactions by other cards to the same account.

```json
{"openapi":"3.0.1","info":{"title":"IOBWS 3.0 Cards","version":"v1"},"tags":[{"name":"CardInformationServiceApi","description":""}],"servers":[{"url":"https://apigw.arionbanki.is/cards","description":"IOBWS 3.0 Cards API"}],"security":[{"oauth2":["profile","b2b"]}],"components":{"securitySchemes":{"oauth2":{"type":"apiKey","description":"Authorization header using the Bearer scheme","name":"Authorization","in":"header"}},"schemas":{"ReadCardListResponse200Json":{"required":["cards"],"type":"object","properties":{"cards":{"type":"array","items":{"$ref":"#/components/schemas/CardDetails"},"description":"List of card details."}},"additionalProperties":false,"description":"Descriptions of the accessible cards."},"CardDetails":{"required":["cardholderName","currency","expDate","maskedPan","resourceId"],"type":"object","properties":{"resourceId":{"minLength":1,"type":"string","description":"This is the data element to be used in the path when retrieving data from a dedicated account. This shall be filled, if addressable resource are created by the Bank on the /cards endpoint."},"maskedPan":{"maxLength":35,"minLength":1,"type":"string","description":"Masked Primary Account Number."},"currency":{"minLength":1,"pattern":"[A-Z]{3}","type":"string","description":"Masked Primary Account Number."},"ownerName":{"maxLength":140,"type":"string","description":"The name of the legal account owner. If there is more than one owner, multiple names (e.g., two) may be noted here.","nullable":true},"ownerId":{"maxLength":35,"type":"string","description":"OwnerId","nullable":true},"expDate":{"minLength":1,"pattern":"(0[1-9]|1[0-2])/([0-9]{2})","type":"string","description":"Experation date for a card in the form mm/yy."},"issueDate":{"type":"string","description":"Issuing date for a card.","format":"date-time","nullable":true},"cardholderName":{"minLength":1,"type":"string","description":"Name of card holder"},"cardholderId":{"maxLength":35,"type":"string","description":"Id of card holder.","nullable":true},"panId":{"type":"string","description":"Scoped identifier to be used as a replacement for the Primary Account Number when referencing card.","nullable":true},"bank":{"pattern":"[0-9]{3,4}","type":"string","description":"Icelandic bank number.","nullable":true},"name":{"maxLength":70,"type":"string","description":"Name of the account, as assigned by the Bank, in agreement with the account owner in order to provide an additional means of identification of the account.","nullable":true},"displayName":{"maxLength":70,"type":"string","description":"Name of the account as defined by the user within online channels.","nullable":true},"product":{"maxLength":35,"type":"string","description":"Product Name of the Bank for this account, proprietary definition.","nullable":true},"status":{"$ref":"#/components/schemas/AccountStatus"},"usage":{"$ref":"#/components/schemas/UsageEnum"},"details":{"maxLength":500,"type":"string","description":"Specifications that might be provided by the Bank:   - characteristics of the account   - characteristics of the relevant card","nullable":true},"creditLimit":{"$ref":"#/components/schemas/Amount"},"balances":{"type":"array","items":{"$ref":"#/components/schemas/Balance"},"description":"A list of balances regarding this account, e.g. the current balance, the last booked balance. The list might be restricted to the current balance.","nullable":true},"links":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/HrefType"},"description":"Links to the card account that provide direct access to retrieve account information, such as balances or transactions.","nullable":true}},"additionalProperties":false,"description":"Card details."},"AccountStatus":{"enum":["enabled","deleted","blocked"],"type":"string","description":"Account status. The value is one of the following:   - \\\"enabled\\\": account is available   - \\\"deleted\\\": account is terminated   - \\\"blocked\\\": account is blocked e.g. for legal reasons If this field is not used, than the account is available in the sense of this specification.<p>Possible values:</p>\r\n<ul>\r\n<li><b>EnabledEnum</b>: Enum EnabledEnum for enabled</li>\r\n<li><b>DeletedEnum</b>: Enum DeletedEnum for deleted</li>\r\n<li><b>BlockedEnum</b>: Enum BlockedEnum for blocked</li>\r\n</ul>\r\n"},"UsageEnum":{"enum":["PRIV","ORGA"],"type":"string","description":"Specifies the usage of the account:   * PRIV: private personal account   * ORGA: professional account<p>Possible values:</p>\r\n<ul>\r\n</ul>\r\n"},"Amount":{"required":["_Amount","currency"],"type":"object","properties":{"currency":{"minLength":1,"pattern":"[A-Z]{3}","type":"string","description":"ISO 4217 Alpha 3 currency code."},"_Amount":{"minLength":1,"pattern":"-?[0-9]{1,14}(\\.[0-9]{1,3})?","type":"string","description":"Gets or sets the amount with fractional digits. Fractions must comply with the currency definition.\r\nUp to 14 significant figures are allowed. Negative amounts are prefixed with a minus sign.\r\nThe decimal separator is a dot.\r\n            \r\n<example>\r\nValid representations for EUR with up to two decimals are:\r\n  - 1056\r\n  - 5768.2\r\n  - -1.50\r\n  - 5877.78\r\n</example>"}},"additionalProperties":false,"description":""},"Balance":{"required":["balanceAmount","balanceType"],"type":"object","properties":{"balanceAmount":{"$ref":"#/components/schemas/Amount"},"balanceType":{"$ref":"#/components/schemas/BalanceType"},"creditLimitIncluded":{"type":"boolean","description":"A flag indicating if the credit limit of the corresponding account is included in the calculation of the balance, where applicable.","nullable":true},"lastChangeDateTime":{"type":"string","description":"This data element might be used to indicate e.g. with the expected or booked balance that no action is known on the account, which is not yet booked.","format":"date-time","nullable":true},"referenceDate":{"type":"string","description":"Reference date of the balance.","format":"date-time","nullable":true},"lastCommittedTransaction":{"maxLength":35,"type":"string","description":"\\\"entryReference\\\" of the last commited transaction to support the intermediary service in identifying whether all user's transactions are already known.","nullable":true}},"additionalProperties":false,"description":"A single balance element."},"BalanceType":{"enum":["closingBooked","expected","openingBooked","interimAvailable","interimBooked","forwardAvailable","nonInvoiced"],"type":"string","description":"The following balance types are defined:   - \\\"closingBooked\\\":      Balance of the account at the end of the pre-agreed account reporting period.      It is the sum of the opening booked balance at the beginning of the period and all entries booked      to the account during the pre-agreed account reporting period.          For card-accounts, this is composed of            - invoiced, but not yet paid entries        - \\\"expected\\\":     Balance composed of booked entries and pending items known at the time of calculation,      which projects the end of day balance if everything is booked on the account and no other entry is posted.          For card accounts, this is composed of:       - invoiced, but not yet paid entries       - not yet invoiced but already booked entries and       - pending items (not yet booked)          For card-accounts:          \\\"money to spend with the value of a pre-approved credit limit on the card account\\\"        - \\\"openingBooked\\\":     Book balance of the account at the beginning of the account reporting period.      It always equals the closing book balance from the previous report.   - \\\"interimAvailable\\\":     Available balance calculated in the course of the account ?servicer?s business day,      at the time specified, and subject to further changes during the business day.      The interim balance is calculated on the basis of booked credit and debit items during the calculation      time/period specified.          For card-accounts, this is composed of:       - invoiced, but not yet paid entries       - not yet invoiced but already booked entries   - \\\"interimBooked\\\":     Balance calculated in the course of the account servicer's business day, at the time specified,      and subject to further changes during the business day.      The interim balance is calculated on the basis of booked credit and debit items during the calculation time/period      specified.   - \\\"forwardAvailable\\\":     Forward available balance of money that is at the disposal of the account owner on the date specified.   - \\\"nonInvoiced\\\":      Only for card accounts, to be checked yet.<p>Possible values:</p>\r\n<ul>\r\n<li><b>ClosingBookedEnum</b>: Enum ClosingBookedEnum for closingBooked</li>\r\n<li><b>ExpectedEnum</b>: Enum ExpectedEnum for expected</li>\r\n<li><b>OpeningBookedEnum</b>: Enum OpeningBookedEnum for openingBooked</li>\r\n<li><b>InterimAvailableEnum</b>: Enum InterimAvailableEnum for interimAvailable</li>\r\n<li><b>InterimBookedEnum</b>: Enum InterimBookedEnum for interimBooked</li>\r\n<li><b>ForwardAvailableEnum</b>: Enum ForwardAvailableEnum for forwardAvailable</li>\r\n<li><b>NonInvoicedEnum</b>: Enum NonInvoicedEnum for nonInvoiced</li>\r\n</ul>\r\n"},"HrefType":{"type":"object","properties":{"href":{"type":"string","description":"Href.","nullable":true}},"additionalProperties":false,"description":"Link to a resource."},"Error400IOBWS":{"type":"object","properties":{"messages":{"type":"array","items":{"$ref":"#/components/schemas/Message400"},"description":"Category of the intermediary service message category.","nullable":true},"links":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/HrefType"},"description":"A _link object with all available link types.","nullable":true}},"additionalProperties":false,"description":"IOBWS specific definition of reporting error information in case of a HTTP error code 400."},"Message400":{"required":["category","code"],"type":"object","properties":{"category":{"$ref":"#/components/schemas/MessageCategory"},"code":{"$ref":"#/components/schemas/MessageCode400"},"path":{"type":"string","description":"Path to the specific property or location within the request payload or resource \r\nthat caused the error. Helps pinpoint the exact issue in nested objects, arrays, \r\nor URL path segments for easier debugging.","nullable":true},"text":{"maxLength":500,"type":"string","description":"Additional explaining text to the intermediary service.","nullable":true}},"additionalProperties":false,"description":""},"MessageCategory":{"enum":["ERROR","WARNING"],"type":"string","description":"Category of the intermediary service message category.<p>Possible values:</p>\r\n<ul>\r\n<li><b>ERROREnum</b>: Enum ERROREnum for ERROR</li>\r\n<li><b>WARNINGEnum</b>: Enum WARNINGEnum for WARNING</li>\r\n</ul>\r\n"},"MessageCode400":{"enum":["FORMAT_ERROR","PARAMETER_NOT_CONSISTENT","PARAMETER_NOT_SUPPORTED","SERVICE_INVALID","RESOURCE_UNKNOWN","RESOURCE_EXPIRED","RESOURCE_BLOCKED","TIMESTAMP_INVALID","PERIOD_INVALID","SCA_METHOD_UNKNOWN","SCA_INVALID","CONSENT_UNKNOWN","SESSIONS_NOT_SUPPORTED"],"type":"string","description":"Message codes defined for HTTP Error code 400 (BAD_REQUEST).<p>Possible values:</p>\r\n<ul>\r\n<li><b>FORMATERROREnum</b>: Enum FORMATERROREnum for FORMAT_ERROR</li>\r\n<li><b>PARAMETERNOTCONSISTENTEnum</b>: Enum PARAMETERNOTCONSISTENTEnum for PARAMETER_NOT_CONSISTENT</li>\r\n<li><b>PARAMETERNOTSUPPORTEDEnum</b>: Enum PARAMETERNOTSUPPORTEDEnum for PARAMETER_NOT_SUPPORTED</li>\r\n<li><b>SERVICEINVALIDEnum</b>: Enum SERVICEINVALIDEnum for SERVICE_INVALID</li>\r\n<li><b>RESOURCEUNKNOWNEnum</b>: Enum RESOURCEUNKNOWNEnum for RESOURCE_UNKNOWN</li>\r\n<li><b>RESOURCEEXPIREDEnum</b>: Enum RESOURCEEXPIREDEnum for RESOURCE_EXPIRED</li>\r\n<li><b>RESOURCEBLOCKEDEnum</b>: Enum RESOURCEBLOCKEDEnum for RESOURCE_BLOCKED</li>\r\n<li><b>TIMESTAMPINVALIDEnum</b>: Enum TIMESTAMPINVALIDEnum for TIMESTAMP_INVALID</li>\r\n<li><b>PERIODINVALIDEnum</b>: Enum PERIODINVALIDEnum for PERIOD_INVALID</li>\r\n<li><b>SCAMETHODUNKNOWNEnum</b>: Enum SCAMETHODUNKNOWNEnum for SCA_METHOD_UNKNOWN</li>\r\n<li><b>SCAINVALIDEnum</b>: Enum SCAINVALIDEnum for SCA_INVALID</li>\r\n<li><b>CONSENTUNKNOWNEnum</b>: Enum CONSENTUNKNOWNEnum for CONSENT_UNKNOWN</li>\r\n<li><b>SESSIONSNOTSUPPORTEDEnum</b>: Enum SESSIONSNOTSUPPORTEDEnum for SESSIONS_NOT_SUPPORTED</li>\r\n</ul>\r\n"},"Error401IOBWS":{"type":"object","properties":{"messages":{"type":"array","items":{"$ref":"#/components/schemas/Message401"},"description":"IOBWS specific definition of reporting error information in case of a HTTP error code 401.","nullable":true},"links":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/HrefType"},"description":"A _link object with all available link types.","nullable":true}},"additionalProperties":false,"description":"IOBWS specific definition of reporting error information in case of a HTTP error code 401."},"Message401":{"required":["category","code"],"type":"object","properties":{"category":{"$ref":"#/components/schemas/MessageCategory"},"code":{"$ref":"#/components/schemas/MessageCode401"},"path":{"type":"string","description":"Path to the specific property or location within the request payload or resource \r\nthat caused the error. Helps pinpoint the exact issue in nested objects, arrays, \r\nor URL path segments for easier debugging.","nullable":true},"text":{"maxLength":500,"type":"string","description":"Additional explaining text to the intermediary service.","nullable":true}},"additionalProperties":false,"description":""},"MessageCode401":{"enum":["CERTIFICATE_INVALID","ROLE_INVALID","CERTIFICATE_EXPIRED","CERTIFICATE_BLOCKED","CERTIFICATE_REVOKE","CERTIFICATE_MISSING","SIGNATURE_INVALID","SIGNATURE_MISSING","CORPORATE_ID_INVALID","USR_CREDENTIALS_INVALID","CONSENT_INVALID","CONSENT_EXPIRED","TOKEN_UNKNOWN","TOKEN_INVALID","TOKEN_EXPIRED"],"type":"string","description":"Message codes defined for HTTP Error code 401 (UNAUTHORIZED).<p>Possible values:</p>\r\n<ul>\r\n<li><b>CERTIFICATEINVALIDEnum</b>: Enum CERTIFICATEINVALIDEnum for CERTIFICATE_INVALID</li>\r\n<li><b>ROLEINVALIDEnum</b>: Enum ROLEINVALIDEnum for ROLE_INVALID</li>\r\n<li><b>CERTIFICATEEXPIREDEnum</b>: Enum CERTIFICATEEXPIREDEnum for CERTIFICATE_EXPIRED</li>\r\n<li><b>CERTIFICATEBLOCKEDEnum</b>: Enum CERTIFICATEBLOCKEDEnum for CERTIFICATE_BLOCKED</li>\r\n<li><b>CERTIFICATEREVOKEEnum</b>: Enum CERTIFICATEREVOKEEnum for CERTIFICATE_REVOKE</li>\r\n<li><b>CERTIFICATEMISSINGEnum</b>: Enum CERTIFICATEMISSINGEnum for CERTIFICATE_MISSING</li>\r\n<li><b>SIGNATUREINVALIDEnum</b>: Enum SIGNATUREINVALIDEnum for SIGNATURE_INVALID</li>\r\n<li><b>SIGNATUREMISSINGEnum</b>: Enum SIGNATUREMISSINGEnum for SIGNATURE_MISSING</li>\r\n<li><b>CORPORATEIDINVALIDEnum</b>: Enum CORPORATEIDINVALIDEnum for CORPORATE_ID_INVALID</li>\r\n<li><b>USRCREDENTIALSINVALIDEnum</b>: Enum USRCREDENTIALSINVALIDEnum for USR_CREDENTIALS_INVALID</li>\r\n<li><b>CONSENTINVALIDEnum</b>: Enum CONSENTINVALIDEnum for CONSENT_INVALID</li>\r\n<li><b>CONSENTEXPIREDEnum</b>: Enum CONSENTEXPIREDEnum for CONSENT_EXPIRED</li>\r\n<li><b>TOKENUNKNOWNEnum</b>: Enum TOKENUNKNOWNEnum for TOKEN_UNKNOWN</li>\r\n<li><b>TOKENINVALIDEnum</b>: Enum TOKENINVALIDEnum for TOKEN_INVALID</li>\r\n<li><b>TOKENEXPIREDEnum</b>: Enum TOKENEXPIREDEnum for TOKEN_EXPIRED</li>\r\n</ul>\r\n"},"Error403IOBWS":{"type":"object","properties":{"messages":{"type":"array","items":{"$ref":"#/components/schemas/Message403"},"description":"IOBWS specific definition of reporting error information in case of a HTTP error code 403.","nullable":true},"links":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/HrefType"},"description":"A _link object with all available link types.","nullable":true}},"additionalProperties":false,"description":"IOBWS specific definition of reporting error information in case of a HTTP error code 403."},"Message403":{"required":["category","code"],"type":"object","properties":{"category":{"$ref":"#/components/schemas/MessageCategory"},"code":{"$ref":"#/components/schemas/MessageCode403"},"path":{"type":"string","description":"Path to the specific property or location within the request payload or resource \r\nthat caused the error. Helps pinpoint the exact issue in nested objects, arrays, \r\nor URL path segments for easier debugging.","nullable":true},"text":{"maxLength":500,"type":"string","description":"Additional explaining text to the intermediary service.","nullable":true}},"additionalProperties":false,"description":""},"MessageCode403":{"enum":["CONSENT_UNKNOWN","SERVICE_BLOCKED","RESOURCE_UNKNOWN","RESOURCE_EXPIRED"],"type":"string","description":"Message codes defined for HTTP Error code 403 (FORBIDDEN).<p>Possible values:</p>\r\n<ul>\r\n<li><b>CONSENTUNKNOWNEnum</b>: Enum CONSENTUNKNOWNEnum for CONSENT_UNKNOWN</li>\r\n<li><b>SERVICEBLOCKEDEnum</b>: Enum SERVICEBLOCKEDEnum for SERVICE_BLOCKED</li>\r\n<li><b>RESOURCEUNKNOWNEnum</b>: Enum RESOURCEUNKNOWNEnum for RESOURCE_UNKNOWN</li>\r\n<li><b>RESOURCEEXPIREDEnum</b>: Enum RESOURCEEXPIREDEnum for RESOURCE_EXPIRED</li>\r\n</ul>\r\n"},"Error404IOBWS":{"type":"object","properties":{"messages":{"type":"array","items":{"$ref":"#/components/schemas/Message404"},"description":"IOBWS specific definition of reporting error information in case of a HTTP error code 404.","nullable":true},"links":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/HrefType"},"description":"A _link object with all available link types.","nullable":true}},"additionalProperties":false,"description":"IOBWS specific definition of reporting error information in case of a HTTP error code 404."},"Message404":{"required":["category","code"],"type":"object","properties":{"category":{"$ref":"#/components/schemas/MessageCategory"},"code":{"$ref":"#/components/schemas/MessageCode404"},"path":{"type":"string","description":"Path to the specific property or location within the request payload or resource \r\nthat caused the error. Helps pinpoint the exact issue in nested objects, arrays, \r\nor URL path segments for easier debugging.","nullable":true},"text":{"maxLength":500,"type":"string","description":"Additional explaining text to the intermediary service.","nullable":true}},"additionalProperties":false,"description":""},"MessageCode404":{"enum":["RESOURCE_UNKNOWN"],"type":"string","description":"Message codes defined for HTTP Error code 404 (NOT FOUND).<p>Possible values:</p>\r\n<ul>\r\n<li><b>RESOURCEUNKNOWNEnum</b>: Enum RESOURCEUNKNOWNEnum for RESOURCE_UNKNOWN</li>\r\n</ul>\r\n"},"Error405IOBWS":{"type":"object","properties":{"messages":{"type":"array","items":{"$ref":"#/components/schemas/Message405"},"description":"IOBWS specific definition of reporting error information in case of a HTTP error code 405.","nullable":true},"links":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/HrefType"},"description":"A _link object with all available link types.","nullable":true}},"additionalProperties":false,"description":"IOBWS specific definition of reporting error information in case of a HTTP error code 405."},"Message405":{"required":["category","code"],"type":"object","properties":{"category":{"$ref":"#/components/schemas/MessageCategory"},"code":{"$ref":"#/components/schemas/MessageCode405"},"path":{"type":"string","description":"Path to the specific property or location within the request payload or resource \r\nthat caused the error. Helps pinpoint the exact issue in nested objects, arrays, \r\nor URL path segments for easier debugging.","nullable":true},"text":{"maxLength":500,"type":"string","description":"Additional explaining text to the intermediary service.","nullable":true}},"additionalProperties":false,"description":""},"MessageCode405":{"enum":["SERVICE_INVALID"],"type":"string","description":"Message codes defined for HTTP Error code 405 (METHOD NOT ALLOWED).<p>Possible values:</p>\r\n<ul>\r\n<li><b>SERVICEINVALIDEnum</b>: Enum SERVICEINVALIDEnum for SERVICE_INVALID</li>\r\n</ul>\r\n"},"Error429IOBWS":{"type":"object","properties":{"messages":{"type":"array","items":{"$ref":"#/components/schemas/Message429"},"description":"IOBWS specific definition of reporting error information in case of a HTTP error code 429.","nullable":true},"links":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/HrefType"},"description":"A _link object with all available link types.","nullable":true}},"additionalProperties":false,"description":"IOBWS specific definition of reporting error information in case of a HTTP error code 429."},"Message429":{"required":["category","code"],"type":"object","properties":{"category":{"$ref":"#/components/schemas/MessageCategory"},"code":{"$ref":"#/components/schemas/MessageCode429"},"path":{"type":"string","description":"Path to the specific property or location within the request payload or resource \r\nthat caused the error. Helps pinpoint the exact issue in nested objects, arrays, \r\nor URL path segments for easier debugging.","nullable":true},"text":{"maxLength":500,"type":"string","description":"Additional explaining text to the intermediary service.","nullable":true}},"additionalProperties":false,"description":""},"MessageCode429":{"enum":["ACCESS_EXCEEDED"],"type":"string","description":"Message codes for HTTP Error code 429 (TOO MANY REQUESTS).<p>Possible values:</p>\r\n<ul>\r\n<li><b>ACCESSEXCEEDEDEnum</b>: Enum ACCESSEXCEEDEDEnum for ACCESS_EXCEEDED</li>\r\n</ul>\r\n"}}},"paths":{"/api/v1/cards":{"get":{"tags":["CardInformationServiceApi"],"summary":"Read list of cards.","description":"Reads a list of cards potentially with additional information, e.g. balance information.  It is assumed that a consent of the user to this access is already given and stored on the Bank's system. The addressed list of cards depends then on the stored consent addressed by consentId, respectively the OAuth2 access token.  Please note, that the current line of credit of a given card might be tighter than what the balance response will suggest, due to credit limits on the card account and transactions by other cards to the same account.","operationId":"ReadListOfCards","parameters":[{"name":"xRequestID","in":"header","description":"ID of the request, unique to the call, as determined by the initiating party.","schema":{"type":"string","format":"uuid"}},{"name":"Ocp-Apim-Subscription-Key","in":"header","description":"Azure API management subscription key","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReadCardListResponse200Json"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error400IOBWS"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error401IOBWS"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error403IOBWS"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error404IOBWS"}}}},"405":{"description":"Method Not Allowed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error405IOBWS"}}}},"408":{"description":"Request Timeout"},"415":{"description":"Unsupported Media Type"},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error429IOBWS"}}}},"500":{"description":"Internal Server Error"},"503":{"description":"Service Unavailable"}}}}}}
```

{% openapi src="/files/UNzTo7ngE5bRWlF6jhD4" path="/api/v1/cards/{cardId}" method="get" %}
[swagger (9).json](https://4095428740-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWRKRXR147Y5hgO0DneWg%2Fuploads%2FOxnZ1a143h5pz5UCRkBY%2Fswagger%20\(9\).json?alt=media\&token=adb0f8a9-3f26-43d6-a857-8f26e5aaf7a9)
{% endopenapi %}

{% openapi src="/files/UNzTo7ngE5bRWlF6jhD4" path="/api/v1/cards/{cardId}/transactions" method="get" %}
[swagger (9).json](https://4095428740-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWRKRXR147Y5hgO0DneWg%2Fuploads%2FOxnZ1a143h5pz5UCRkBY%2Fswagger%20\(9\).json?alt=media\&token=adb0f8a9-3f26-43d6-a857-8f26e5aaf7a9)
{% endopenapi %}

{% hint style="info" %}
**Good to know:** These API methods were auto-generated from an example OpenAPI file. You'll see that it's not editable – that's because the contents are synced to a URL! Any time the linked file changes, the documentation will change too.
{% endhint %}