# Get a mapping preview (/reference/api/plugins/getMappingPreview)

Returns a mapping preview: pending, or ready with the fields the connector rendered, or failed with its reason. Needs `connectors.manage`, or the connector's own key.