Stannp | Direct Mail Marketing Platform
package icon
Choose the right postage when sending on the API Are you sending personal information, or marketing content? Before you send your mail, know the key difference between First-Class and USPS Marketing Mail. Read our blog to find out more.

Account

Manage your account balance and top up funds.

Get account balance

You can use the API to check your account balance.

GET

Request Example

curl "https://api-us1.stannp.com/v1/accounts/balance" \
-u {API_KEY}:

Response Example

{
  "success": true,
  "data": {
    "balance": "214.4200"
  }
}

Top up balance

You can use the API to top up your balance if you have a saved card and set one to default. Tip: Consider enabling auto top-up to ensure your sends are not impacted by a low balance.

POST

Parameters

ParameterDetailsDescription
net
str required
The amount to top up. Eg: "10.00". Be aware tax may be added on after.

Request Example

curl "https://api-us1.stannp.com/v1/accounts/topup" \
-u {API_KEY}: \
-d "net=10.00"

Response Example

{
  "success": true,
  "data": {
    "receipt_pdf": "https://www.stannp.com/invoice/12345-uhusdsfsi34545-fgfdfdb.pdf"
  }
}