> This page is for Unified.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.merge.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server.

# Access mapped data

> How to read mapped field values from the API and view mapping configurations in the Merge Dashboard.

---

## Dashboard view

You can view, edit, and delete mappings made by you or your users in your dashboard in the Field Mapping section of each Linked Account's page.

Use our preview values feature to double check your mappings for a Linked Account. In your user's Field Mapping page, input an ID associated with one of Merge's Common Models (eg., an employee ID in Merge). If the mapping is set up correctly, the right set of Remote Field values from your user's application will appear automatically.

![Preview Field Mapping](/_fern-files/merge-test.docs.buildwithfern.com/8ebc4c505ee3eb1e6fc11f2bb849b564b2e659e412ea12f3d58a630ae7507ffd/docs/src/assets/images/docs/guides/field-mapping/PreviewFieldMapping.svg)

You can view, edit, and delete integration-wide mappings in each target field's page.

![Integration-wide Target Field Configuration](/_fern-files/merge-test.docs.buildwithfern.com/b2baee9a52c34c4ebf31629848cf873ae0bf9a5adea6ab64f2d505c2b82ef78d/docs/src/assets/images/docs/guides/field-mapping/IntegWideTargetFieldConfig.svg)

Any Field Mapping changes will be updated in the next sync and will trigger a **full resync** for the modified Common Models on the next scheduled sync.

---

## API response

Field Mapping data is automatically accessible in the Common Model responses returned from Merge's Unified API. No parameters are needed.

Below is a sample request to the Application Common Model after mapping is complete, showing both organization-defined and Linked Account-level targets.

#### Sample response - Application with Field Mappings

```json {22-34}
{
  "id": "92e8a369-fffe-430d-b93a-f7e8a16563f1",
  "remote_id": "98796",
  "candidate": "2872ba14-4084-492b-be96-e5eee6fc33ef",
  "job": "52bf9b5e-0beb-4f6f-8a72-cd4dca7ca633",
  "applied_at": "2021-10-15T00:00:00Z",
  "rejected_at": "2021-11-15T00:00:00Z",
  "source": "Campus recruiting event",
  "credited_to": "58166795-8d68-4b30-9bfb-bfd402479484",
  "current_stage": "d578dfdc-7b0a-4ab6-a2b0-4b40f20eb9ea",
  "reject_reason": "59b25f2b-da02-40f5-9656-9fa0db555784",
  "remote_data": [
    {
      "path": "/candidacies",
      "data": [
        "Varies by platform"
      ]
    }
  ],
  "remote_was_deleted": true,
  "field_mappings": {
    "organization_defined_targets": {
      "technical_assessment_score": {
        "value": "4"
      }
    },
    "linked_account_defined_targets": {
      "previous_role": {
        "value": "Management Consultant"
      }
    }
  }
}
```

You can also use the endpoint [GET /field-mappings](/hris/field-mapping/) to retrieve all Field Mappings for a Linked Account. See our API reference for all Field Mapping endpoints and details (base URL varies by category).