# Castingwords

CastingWords offers high-quality, human-powered transcription services with a RESTful API for seamless integration into various workflows.

- **Category:** transcription
- **Auth:** API_KEY
- **Tools:** 8
- **Triggers:** 0
- **Slug:** `CASTINGWORDS`
- **Version:** 20260211_00

## Tools

### Cancel and Refund Audio File

**Slug:** `CASTINGWORDS_CANCEL_AUDIOFILE`

Tool to cancel an ordered audio file and issue a refund if applicable. Use when no transcription work has been done on the file (Pre-Processing, Audio Processing, Error states).

### Get Prepay Balance

**Slug:** `CASTINGWORDS_GET_PREPAY_BALANCE`

Tool to retrieve the current prepay balance for the account. Use when you need to check available funds before placing new transcription orders.

### Get registered webhook URL

**Slug:** `CASTINGWORDS_GET_WEBHOOK`

Tool to retrieve the currently registered webhook URL for account notifications. Use when you need to verify your webhook setup.

### Order Transcript

**Slug:** `CASTINGWORDS_ORDER_TRANSCRIPT`

Create a transcription order for audio/video files at publicly accessible URLs. Returns order ID and audiofile IDs for tracking. Requires prepaid balance for non-test orders. Use test=true to validate URLs without charges.

### Order Upgrades

**Slug:** `CASTINGWORDS_ORDER_UPGRADES`

Tool to order an upgrade for a specific audio file. Use after transcription is complete to add items like timestamps or extra editing. Example: 'Order timestamps for file 12345'.

### Register Webhook

**Slug:** `CASTINGWORDS_REGISTER_WEBHOOK`

Registers a webhook URL to receive CastingWords event notifications. When events occur (e.g., transcript completion, refund issued, difficult audio), CastingWords will POST to your registered URL with event details. Use CASTINGWORDS_GET_WEBHOOK to verify the current webhook, and CASTINGWORDS_TEST_WEBHOOK to test notifications.

### List Available SKUs

**Slug:** `CASTINGWORDS_SKU_LIST`

Retrieves all available CastingWords transcription service SKUs with pricing. Use this tool to discover available services (transcription, captions, etc.) and their per-minute prices before placing an order. Returns SKU codes needed for order placement.

### Test Webhook Call

**Slug:** `CASTINGWORDS_TEST_WEBHOOK`

Tool to request a test webhook call for a specific event type. Use after registering a webhook URL to ensure webhook notifications are functioning properly.
