Developer resources

Public API

Explore the Echoes of Astra API endpoints and the query parameters they accept. All endpoints listed here use the GET method.

Base URLhttps://api.echoesofastra.com

15 endpoints documented

Change history

API version history

Coming soon

Track API releases, new and deprecated endpoints, and breaking changes.

Card list update history

Coming soon

See which cards and sets were added or changed in each card data update.

Cards

GET/getmastercardrecord

Get master card record

Returns a list of cards with one card per name, prioritizing the first non-first-edition card. The response contains StatusCode and Cards.

GET/getallcardrecords

Get all card records

Returns every card variant record. The response contains StatusCode and Cards.

GET/searchcardsbyname

Search cards by name

Returns card variant records matching the card name. The response contains StatusCode and Cards.

Query parameters

cardName: Name (or partial name) of the card to search for.

GET/getcardsinsetv2

Get cards in set (v2)

Returns the card variant records in an expansion. The response contains StatusCode and the card list under the Icons key.

Query parameters

expansionCode: Code of the expansion to retrieve cards from.

Reference data

GET/getaffinitiesv2

Get affinities (v2)

Returns the available card affinities. The response contains StatusCode and Affinities.

GET/getcardtypesv2

Get card types (v2)

Returns the available card types. The response contains StatusCode and CardType.

GET/geticonsv2

Get icons (v2)

Returns the available icons. The response contains StatusCode and Icons.

GET/getsetsv2

Get sets (v2)

Returns the available card sets. The response contains StatusCode and the set list under the Icons key.

Deprecated

GET/getallcardsDEPRECATED

Get all cards

Returns card data.

Deprecated. Use /getmastercardrecord instead.

GET/getaffinitiesDEPRECATED

Get affinities

Returns the available card affinities.

Deprecated. Use /getaffinitiesv2 instead.

GET/getcardtypesDEPRECATED

Get card types

Returns the available card types.

Deprecated. Use /getcardtypesv2 instead.

GET/geticonsDEPRECATED

Get icons

Returns the available card icons.

Deprecated. Use /geticonsv2 instead.

GET/getcardbyidDEPRECATED

Get card by ID

Returns card data for the specified card ID. If omitted, the API uses NONE.

Deprecated. Use /searchcardsbyname instead.

Query parameters

cardId: ID of the card to retrieve.

GET/getcardsinsetDEPRECATED

Get cards in set

Returns card data for the specified set. If setId is omitted, the API uses NONE.

Deprecated. Use /getcardsinsetv2 instead.

Query parameters

setId: ID of the set to retrieve cards from.

GET/getsetsDEPRECATED

Get sets

Returns card set data. The allowPrivate and accessKey parameters are still accepted but no longer used.

Deprecated. Use /getsetsv2 instead.

Query parameters

allowPrivate: Ignored.
accessKey: Ignored.