---
title: "List migration mappings"
method: GET
path: "/migration_mappings"
tags: ["Migration Mappings"]
---

# List migration mappings

`GET /migration_mappings`

List migration mappings. Either tenant or old_tenant may view the records they are part of.

## Query parameters

- `resource_id` string
- `sort_by` string[]
- `old_resource_id` string[]
- `resource_type` MigrationMappingResourceType[]
- `tenant` TenantId[]
- `page_token` string — Optional pagination token to be provided to retrieve subsequent pages, returned from previous get
- `limit` integer — Maximum number of objects to return per page. If the limit is greater than 100, then it will be set to 100.
- `old_tenant` TenantId[]

## Response `200`

List of migration mappings

- MigrationMappingList
  - `migration_mappings` MigrationMapping[], required — Array of migration mappings.
    - `creation_time` string, date-time, required — The date and time the resource was created.
    - `deletion_time` string, date-time, nullable — The date and time the resource was deleted.
    - `id` string, uuid, required — The unique identifier for the migration mapping.
    - `last_updated_time` string, date-time, required — The date and time the resource was last updated.
    - `old_resource_id` string, required — The previous resource ID under the old tenant.
    - `old_tenant` string, required — The id of the tenant containing the resource. This is relevant for Fintechs that have multiple workspaces.
    - `resource_id` string, required — The new/current resource ID.
    - `resource_type` 'ACCOUNT' | 'BUSINESS' | 'PERSON', required — The type of resource being mapped.
    - `tenant` string, required — The id of the tenant containing the resource. This is relevant for Fintechs that have multiple workspaces.
  - `next_page_token` string — If returned, use the next_page_token to query for the next page of results. Not returned if there are no more rows.

## Other responses

- `400` — BadRequest
- `401` — Unauthorized
- `403` — Forbidden error
- `500` — Internal server error

---

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