List Redemption Codes

Returns all individual codes within a redemption code group

List the individual codes within a redemption code group, sorted by createdAt ascending.

GEThttps://example.thoughtindustries.com/incoming/v2/redemptionCodes/:id/codes

Example request

curl "https://example.thoughtindustries.com/incoming/v2/redemptionCodes/<group-uuid>/codes" \
  -H 'Authorization: Bearer YOUR_API_KEY'

Parameters

Name	Type	Required	Location	Description
`id`	`uuid`	Yes	path	Redemption code group UUID.

Returns 404 with { "errors": ["Redemption code not found"] } if the group does not exist or does not belong to the requesting company.

Example response

{
  "codes": [
    {
      "code": "SPRING-AB12CD34",
      "redeemed": true,
      "redeemedAt": "Apr 12, 2025",
      "createdAt": "Mar 01, 2025",
      "firstName": "Jordan",
      "lastName": "Lee",
      "email": "[email protected]"
    },
    {
      "code": "SPRING-EF56GH78",
      "redeemed": false,
      "redeemedAt": null,
      "createdAt": "Mar 01, 2025",
      "firstName": "",
      "lastName": "",
      "email": ""
    },
    {
      "code": "SPRING-IJ90KL12",
      "redeemed": true,
      "redeemedAt": "Apr 20, 2025",
      "createdAt": "Mar 01, 2025",
      "firstName": "Deleted",
      "lastName": "User",
      "email": "[email protected]"
    }
  ]
}

The redeeming user's identity is exposed only through the firstName, lastName, and email fields — there is no redeemedByUserId. Anonymized or deleted users return "Deleted" / "User" / [email protected] rather than their original details.

Response fields

Field	Type	Description
`codes[].code`	`string`	The redemption code.
`codes[].redeemed`	`boolean`	Whether the code has been redeemed.
`codes[].redeemedAt`	`string`	Formatted date, or null if not redeemed.
`codes[].createdAt`	`string`	Formatted date.
`codes[].firstName`	`string`	Redeeming user's first name (empty if not redeemed, `"Deleted"` if anonymized).
`codes[].lastName`	`string`	Redeeming user's last name (empty if not redeemed, `"User"` if anonymized).
`codes[].email`	`string`	Redeeming user's email (empty if not redeemed, `[email protected]` if anonymized).