# Phrase Uploads API

**Canonical:** https://apis.io/apis/phrase/phrase-uploads-api/  
**Provider:** Phrase — https://apis.io/providers/phrase/  
**Base URL:** https://api.phrase.com/v2  
**Documentation:** https://developers.phrase.com/api/

Phrase Uploads API is one of 57 APIs that [Phrase](https://apis.io/providers/phrase/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Uploads. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, authentication docs, and a getting-started guide.

### Formats We support all common localization file formats. For a detailed overview, see our [Format Guide](https://support.phrase.com/hc/en-us/sections/6111343326364). ### Processing Uploads will be processed asynchronously and thus the data might not be imported yet although the upload is completed. Therefore we recommend to evaluate the returned <code>state</code> field for information on the import progress. #### Available States <div class="table-responsive"> <table class="basic-table"> <thead> <tr class="basic-table__row basic-table__row--header"> <th class="basic-table__cell basic-table__cell--header">State</th> <th class="basic-table__cell basic-table__cell--header">Description</th> </tr> </thead> <tbody> <tr> <td class="basic-table__cell"><code>initialized</code></td> <td class="basic-table__cell">Data received.</td> </tr> <tr> <td class="basic-table__cell"><code>waiting_for_preview</code></td> <td class="basic-table__cell">Upload is waiting for preview to be finished.</td> </tr> <tr> <td class="basic-table__cell"><code>waiting</code></td> <td class="basic-table__cell">Upload is waiting for processing.</td> </tr> <tr> <td class="basic-table__cell"><code>processing</code></td> <td class="basic-table__cell">Upload is being processed, data is currently imported.</td> </tr> <tr> <td class="basic-table__cell"><code>success</code></td> <td class="basic-table__cell">Upload is complete and all data is imported.</td> </tr> <tr> <td class="basic-table__cell"><code>error</code></td> <td class="basic-table__cell">Upload or import process failed.</td> </tr> </tbody> </table> </div>

## Machine-readable artifacts (5)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/phrase/refs/heads/main/openapi/phrase-uploads-api-openapi.yml
- **Documentation** — https://developers.phrase.com/api/
- **Authentication** — https://developers.phrase.com/api/#section/Authentication
- **GettingStarted** — https://help.phrase.com/help/phrase-in-your-coding-workflow
- **GraphQL** — https://raw.githubusercontent.com/api-evangelist/phrase/refs/heads/main/graphql/phrase-graphql.md

## Other Phrase APIs (12)

- [Phrase Accounts API](https://apis.io/apis/phrase/phrase-accounts-api/)
- [Phrase Authorizations API](https://apis.io/apis/phrase/phrase-authorizations-api/)
- [Phrase Automations API](https://apis.io/apis/phrase/phrase-automations-api/)
- [Phrase Blacklisted Keys API](https://apis.io/apis/phrase/phrase-blacklisted-keys-api/)
- [Phrase Branches API](https://apis.io/apis/phrase/phrase-branches-api/)
- [Phrase Comment Reactions API](https://apis.io/apis/phrase/phrase-comment-reactions-api/)
- [Phrase Comment Replies API](https://apis.io/apis/phrase/phrase-comment-replies-api/)
- [Phrase Comments API](https://apis.io/apis/phrase/phrase-comments-api/)
- [Phrase Custom Metadata API](https://apis.io/apis/phrase/phrase-custom-metadata-api/)
- [Phrase Distributions API](https://apis.io/apis/phrase/phrase-distributions-api/)
- [Phrase Documents API](https://apis.io/apis/phrase/phrase-documents-api/)
- [Phrase Figma attachments API](https://apis.io/apis/phrase/phrase-figma-attachments-api/)

## Tags

Uploads

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/phrase/phrase-uploads-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/phrase/.