Get Reissue Address
This endpoint retrieves the shipping address associated with a specific payment card for the purpose of card reissuance. When a physical card needs to be replaced or reissued, this call returns the address on file so partners can confirm or update the delivery destination before initiating the reissue process.
Endpoint
GET /api/paymentCards/reissue/address/{paymentCardId}
Authentication
Bearer token required. Obtain via:
POST https://api.banking.netevia.dev/api/auth/v2Include in header: Authorization: Bearer {token}
Token lifetime: 10 minutes. Refresh via POST /api/auth/refresh.
When to use
Use this endpoint before reissuing a physical payment card to verify the shipping address currently stored for that card. This is useful when a customer requests a replacement card and you need to confirm the delivery address is correct, or when building a UI that prefills an address form for the customer to review and update prior to reissuance.
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| paymentCardId | string | Yes | The unique identifier of the payment card whose reissue address is being retrieved. |
Response
200 OK
| Field | Type | Description |
|---|---|---|
| streetAddress | string | Primary street address line (e.g., house number and street name). |
| extendedAddress | string | Secondary address line such as apartment, suite, or unit number. |
| postalCode | string | ZIP or postal code of the address. |
| locality | string | City or town name. |
| region | string | State, province, or region code. |
| countryCodeAlpha3 | string | Three-letter ISO 3166-1 alpha-3 country code (e.g., "USA"). |
{
"streetAddress": "123 Main Street",
"extendedAddress": "Suite 400",
"postalCode": "30301",
"locality": "Atlanta",
"region": "GA",
"countryCodeAlpha3": "USA"
}Error Codes
| Code | When it happens |
|---|---|
| 400 | The provided paymentCardId is malformed or invalid. |
| 401 | Token missing, expired, or invalid. |
| 403 | Insufficient permissions to access this card's reissue address. |
| 404 | No payment card found for the given paymentCardId. |
| 500 | Internal server error. |
Common Mistakes
- Passing an incorrect or non-existent
paymentCardIdwill return a 404; ensure the ID belongs to an active card under the authenticated partner's context. - This endpoint applies to physical cards only — virtual and burner cards are not shipped and do not have a reissue address on file.
- The
countryCodeAlpha3field uses a three-letter code (e.g., "USA"), not the two-letter ISO 3166-1 alpha-2 format (e.g., "US"); validate accordingly before displaying or comparing values.
Related Endpoints
POST /api/paymentCards/reissue— Initiate the reissuance of a physical payment card.PUT /api/paymentCards/reissue/address/{paymentCardId}— Update the shipping address for a card reissue.GET /api/paymentCards/{paymentCardId}— Retrieve full details for a specific payment card.
Example
curl -X GET https://api.banking.netevia.dev/api/paymentCards/reissue/address/{paymentCardId} \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json"