[Amex] What do I need to know about Amex supplementary cards?

What is a supplementary card?

A supplementary card is an additional card that lets you share the benefits and convenience of your American Express card with family or friends. 

It can be compared to a joint account where all the cards are linked to the same source but, unlike a joint account, supplementary cardholders may not have the same access as the main account holder.

Transactions

The transactions made on these cards show up under the main card's transaction and the balance on them is the same as the balance on the main card: this means that from the main card is it possible to retrieve all the transactions done through the main card and the supplementary ones. 

{
    "timestamp": ,
    "description": ,
    "transaction_type": ,
    "transaction_category": ,
    "transaction_classification": ,
    "amount":,
    "currency":,
    "transaction_id": ,
    "meta": {
        "provider_merchant_name":,
        "transaction_type": ,
        "provider_reference": ,
        "supplementary_card_id":   <-------
}

Account

When consenting on Amex's website only the card the user consents for is shown and when the /cardsendpoint is called, TrueLayer will only return that card.

The only way for getting the account_id of a supplementary card is by connecting a known supplementary card.

Balance

Amex doesn't return balance for supplementary cards, so any calls to the /balance endpoint will receive an access_denied error. This is a design decision made by the provider. The rest of the calls will work as expected.