Need to retrieve a Gift Card balance using REST API

Shopify Discussion

Topic summary

Seeking the correct way to retrieve a Shopify gift card balance via REST API after successfully creating the gift card in Postman and seeing it in the admin.

  • Attempt: Sent a GET request to /admin/api/2023-04/gift_cards/64118069686655.json using basic auth in the URL. Included a JSON body with { “balance”: { “gift_card_id”: 64118069686655 } }.
  • Outcome: Received a Bad Request (400) response.

Key question: What is the proper endpoint/method to GET the balance of an existing gift card? Is a request body needed or supported for this operation?

Status: Unresolved; no guidance or solution provided yet.

Summarized with AI on December 27. AI used: gpt-5.
1

Using Postman I can create a gift card in the admin with an amount that brings back all the data I need. I see the card in the admin but now I want retrieve or GET the balance of that gift card, how do I do that?

This is in my GET - https://{{vault:api-key}}:{{vault:password}}password@store.myshopify.com/admin/api/2023-04/gift_cards/64118069686655.json

My body is

{
“balance”: {
“gift_card_id”: 64118069686655,
}
}
I get a bad request.