Flat API

The Flat API allows you to easily extend the abilities of the [Flat Platform](https://flat.io), with a wide range of use cases including the following: * Creating and importing new music scores using MusicXML, MIDI, Guitar Pro (GP3, GP4, GP5, GPX, GP), PowerTab, TuxGuitar and MuseScore files * Browsing, updating, copying, exporting the user's scores (for example in MP3, WAV or MIDI) * Managing educational resources with Flat for Education: creating & updating the organization accounts, the classes, rosters and assignments. The Flat API is built on HTTP. Our API is RESTful It has predictable resource URLs. It returns HTTP response codes to indicate errors. It also accepts and returns JSON in the HTTP body. The [schema](/swagger.yaml) of this API follows the [OpenAPI Initiative (OAI) specification](https://www.openapis.org/), you can use and work with [compatible Swagger tools](http://swagger.io/open-source-integrations/). This API features Cross-Origin Resource Sharing (CORS) implemented in compliance with [W3C spec](https://www.w3.org/TR/cors/). You can use your favorite HTTP/REST library for your programming language to use Flat's API. This specification and reference is [available on Github](https://github.com/FlatIO/api-reference). Getting Started and learn more: * [API Overview and introduction](https://flat.io/developers/docs/api/) * [Authentication (Personal Access Tokens or OAuth2)](https://flat.io/developers/docs/api/authentication.html) * [SDKs](https://flat.io/developers/docs/api/sdks.html) * [Rate Limits](https://flat.io/developers/docs/api/rate-limits.html) * [Changelog](https://flat.io/developers/docs/api/changelog.html)

Claim this API

Are you the operator of Flat API? Submit a claim to establish contact with us.

Report an Issue

Found something wrong with Flat API? Let us know about broken links, changed auth, deprecated endpoints, or other issues.

Base URL: https://api.flat.io/v2
Auth: unknown
Endpoints: 23
Reachable: unknown
CORS: unknown

Links

Homepage: https://flat.io/developers/docs/api/
API Base: https://api.flat.io/v2

Endpoints

Method Path Summary Auth Last Status Latency
GET /classes List the classes available for the current user
GET /classes/{class} Get the details of a single class
GET /classes/{class}/assignments Assignments listing
GET /classes/{class}/assignments/{assignment}/submissions List the students' submissions
GET /classes/{class}/assignments/{assignment}/submissions/csv CSV Grades exports
GET /classes/{class}/assignments/{assignment}/submissions/excel Excel Grades exports
GET /classes/{class}/assignments/{assignment}/submissions/{submission} Get a student submission
GET /classes/{class}/assignments/{assignment}/submissions/{submission}/comments List the feedback comments of a submission
GET /classes/{class}/assignments/{assignment}/submissions/{submission}/history Get the history of the submission
GET /collections List the collections
GET /collections/{collection} Get collection details
GET /collections/{collection}/scores List the scores contained in a collection
GET /groups/{group} Get group information
GET /groups/{group}/scores List group's scores
GET /organizations/invitations List the organization invitations
GET /scores/{score} Get a score's metadata
GET /scores/{score}/collaborators List the collaborators
GET /scores/{score}/collaborators/{collaborator} Get a collaborator
GET /scores/{score}/comments List comments
GET /scores/{score}/revisions List the revisions
GET /scores/{score}/revisions/{revision} Get a score revision
GET /scores/{score}/revisions/{revision}/{format} Get a score revision data
GET /scores/{score}/submissions List submissions related to the score
GET /scores/{score}/tracks List the audio or video tracks linked to a score
GET /scores/{score}/tracks/{track} Retrieve the details of an audio or video track linked to a score