# Flat API

**Provider:** Flat
**Category:** storage
**Base URL:** `https://api.flat.io/v2`
**Auth:** oauth2 — `Authorization: Bearer <access_token>`
**Rate Limit:** Not officially published
**Free Tier:** Yes — available
**Pricing:** Enterprise / contact sales (subscription)
**Docs:** https://flat.io/developers/docs/api/

## Description

The Flat API allows you to easily extend the abilities of the Flat Platform, 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
* Brow

## Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `https://api.flat.io/v2/classes` | List the classes available for the current user |
| POST | `https://api.flat.io/v2/classes` | Create a new class |
| POST | `https://api.flat.io/v2/classes/enroll/{enrollmentCode}` | Join a class |
| GET | `https://api.flat.io/v2/classes/{class}` | Get the details of a single class |
| PUT | `https://api.flat.io/v2/classes/{class}` | Update the class |
| POST | `https://api.flat.io/v2/classes/{class}/activate` | Activate the class |
| DELETE | `https://api.flat.io/v2/classes/{class}/archive` | Unarchive the class |
| POST | `https://api.flat.io/v2/classes/{class}/archive` | Archive the class |

## Authentication

OAuth 2.0 — obtain an access token via the authorization flow

```
Authorization: Bearer <access_token>
```

## Sample Request

```bash
curl -X GET 'https://api.flat.io/v2/classes' \
  -H 'Authorization: Bearer <access_token>'
```

## Sample Response

```json
{}
```

## Pricing Details

Free: 1 score, 10 private scores for edu. Pro $9/mo. Music notation collaboration.

---

*Source: [API Map](https://apimap.dev/apis/flat/) — CC BY 4.0*