---
title: "Id Mappings"
method: GET
path: "/api/v1/id_mappings/{obj_name}/{obj_ids}"
tags: ["Ids"]
---

# Id Mappings

`GET /api/v1/id_mappings/{obj_name}/{obj_ids}`

Translates IDs from v1 to v2 or vice versa.

IDs are not unique across object types, hence the need to specify the object type.

When V1 ids are provided, the function will return the corresponding V2
ids, if they exist, and vice versa.

When no objects are found, an empty list is returned.

## Path parameters

- `obj_name` 'sections' | 'tasks' | 'comments' | 'reminders' | 'location_reminders' | 'projects', required — Object type for the IDs to translate.
- `obj_ids` string, required — A comma-separated list of IDs

## Response `200`

Successful Response

- IDMapping[]
  - `old_id` string, required
  - `new_id` string, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found

---

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