---
title: "Import levels and bands from CSV"
method: POST
path: "/api/v1/pay-grades-and-bands/import"
tags: ["Public API"]
---

# Import levels and bands from CSV

`POST /api/v1/pay-grades-and-bands/import`

Parse and validate a levels and bands CSV upload and return suggested mappings and validation results.

OAuth Scopes: pay_grades_and_bands.write

## Response `200`

Successfully parsed CSV

- LevelsAndBandsUploadResponse — Schema for levels and bands import upload response
  - `uploadData` string[] — Upload data
  - `columnMap` LevelsAndBandsColumnMap[] — Column map
    - `expectedColumnKey` string, nullable — Expected column key
    - `columnName` string — Column name

## Other responses

- `400` — Multipart request missing file
- `403` — Insufficient permissions
- `422` — Uploaded CSV could not be parsed or validated
- `500` — Internal server error

---

[API](https://skmtc.net/bamboohr/apis/bamboohr-api.md) · [All operations](https://skmtc.net/bamboohr/apis/bamboohr-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bamboohr/bamboohr-api/revisions/19ebf391a399/schema)