# Goody API API

> Goody API API on Apizie: 15 endpoints (Retrieve current user, List order batches, Create an order batch, Retrieve orders for an order batch, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://www.apizie.tech/v1/communication:goody/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `communication:goody`
- Category: Communication
- Status: byok
- Source: https://www.ongoody.com
- Page: https://www.apizie.tech/api/communication/goody
- OpenAPI: https://www.apizie.tech/api/communication/goody/openapi.json

Goody is a new way to send personal and business gifts as easily as a text message. Our business gifting platform, Goody for Business, powers employee engagement, client appreciation, and sales prospecting gifts at…

## Endpoints

### Retrieve current user
`GET https://www.apizie.tech/v1/communication:goody/me-get-current-user` (byok)

### List order batches
`GET https://www.apizie.tech/v1/communication:goody/order-batches-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| page | integer | no | Page for pagination, starting at 1 |
| per_page | integer | no | Items per page for pagination |

### Create an order batch
`POST https://www.apizie.tech/v1/communication:goody/order-batches-create-batch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Retrieve orders for an order batch
`GET https://www.apizie.tech/v1/communication:goody/order-batches-get-orders` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | Order batch ID |
| page | integer | no | Page for pagination, starting at 1 |
| per_page | integer | no | Items per page for pagination |

### Retrieve recipients for an order batch
`GET https://www.apizie.tech/v1/communication:goody/order-batches-get-recipients` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | Order batch ID |
| page | integer | no | Page for pagination, starting at 1 |
| per_page | integer | no | Items per page for pagination |

### Retrieve an order batch
`GET https://www.apizie.tech/v1/communication:goody/order-batches-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | Order batch ID |

### Cancel an order
`POST https://www.apizie.tech/v1/communication:goody/orders-cancel-order` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | id |

### List orders
`GET https://www.apizie.tech/v1/communication:goody/orders-get-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| page | integer | no | Page for pagination, starting at 1 |
| per_page | integer | no | Items per page for pagination |

### Retrieve an order
`GET https://www.apizie.tech/v1/communication:goody/orders-get-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | id |

### Update expiration for an order
`POST https://www.apizie.tech/v1/communication:goody/orders-update-expiration` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | id |
| body | object | no | JSON request body |

### List all payment methods
`GET https://www.apizie.tech/v1/communication:goody/payment-methods-list-all` (byok)

### List all active products
`GET https://www.apizie.tech/v1/communication:goody/products-list-active-products` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| page | integer | no | Page for pagination, starting at 1 |
| per_page | integer | no | Items per page for pagination |
| use_custom_catalog | boolean | no | Limit to custom catalog only (for approved API partners) |

### Create a webhook endpoint
`POST https://www.apizie.tech/v1/communication:goody/webhooks-create-endpoint` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Delete a webhook endpoint
`POST https://www.apizie.tech/v1/communication:goody/webhooks-delete-endpoint` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | Webhook endpoint ID |
| body | object | no | JSON request body |

### List all workspaces
`GET https://www.apizie.tech/v1/communication:goody/workspaces-get-all` (byok)

## Example
```
curl "https://www.apizie.tech/v1/communication:goody/me-get-current-user" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Goody API API?
Create a free Apizie key, then send GET https://www.apizie.tech/v1/communication:goody/me-get-current-user with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Goody API API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Goody API itself also needs your own key from api.ongoody.com.

### Can AI agents use the Goody API API?
Yes. Add the Apizie MCP server (https://www.apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key communication:goody.

### What is the status of the Goody API API?
Needs your own provider key (bring your own key)