# Verato Organization API The Verato Organization API provides comprehensive identity management capabilities for organizations within the Verato LINK platform. This API enables you to: - **Ingest and manage organization identities**: Add, update, and delete organization records with rich demographic and contact information. - **Search and query**: Find organizations using demographic data, native IDs, or link IDs (Verato's golden identifier). - **Lifecycle management**: Soft-delete and restore organization records while preserving data history. - **Merge and link operations**: Consolidate duplicate organizations, manage master data relationships, and maintain data lineage. - **Relationship management**: Define and query relationships between organizations (parent-child, affiliations, etc.). - **Notifications**: Track and audit identity changes and events across your organization data. All operations follow a standard request/response envelope pattern with audit tracking, error handling, and optional response format customization. Version: 2026.1.2 ## Servers Production Organization Link API ``` https://yourveratodomain.com/org-link-ws/svc ``` Sandbox Organization Link API ``` https://yourveratodomain.com/org-link-ws/svc ``` ## Security ### basicAuth Type: http Scheme: basic ## Download OpenAPI description - [Verato Organization API](https://developer.verato.com/_bundle/apis/organization.openapi.yaml) - [POST /postIdentity](https://developer.verato.com/apis/organization.openapi/other/postidentity.md): Adds or updates a record in the Organization entity. Each record is uniquely identified by Source and Native ID; the response returns the Link ID assigned to the record — either a new Link ID or an ex - [POST /demographicsSearch](https://developer.verato.com/apis/organization.openapi/other/demographicssearch.md): Returns one-to-many candidate identities from the Organization entity that have any degree of similarity to the demographic search criteria provided — a fuzzy search useful when you aren't sure which - [POST /demographicsQuery](https://developer.verato.com/apis/organization.openapi/other/demographicsquery.md): Retrieves the single best-matching identity from the Organization entity for the demographic data supplied in the request, using Verato's referential matching algorithm. A match is only returned if it - [POST /identityIdQuery](https://developer.verato.com/apis/organization.openapi/other/identityidquery.md): Retrieves a single identity from the Organization entity using its Verato Link ID. This is the primary way to fetch a full identity record when you already have the Link ID from a prior operation. - [POST /nativeIdQuery](https://developer.verato.com/apis/organization.openapi/other/nativeidquery.md): Retrieves a single identity from the Organization entity using the Source + Native ID of a previously-posted source record. Use this when you know which source-system record you're looking for but don - [POST /deleteSourceIdentity](https://developer.verato.com/apis/organization.openapi/other/deletesourceidentity.md): Physically deletes one of your source records from the Organization entity to keep it in sync when a record is deleted from your source system. If the deleted source record is the entity's only source - [POST /restoreSource](https://developer.verato.com/apis/organization.openapi/other/restoresource.md): Restores a previously soft-deleted source across all Organization entities where it was present, reversing a prior softDeleteSource call. Depending on the current state of the graph, this may reactiva - [POST /softDeleteSource](https://developer.verato.com/apis/organization.openapi/other/softdeletesource.md): Logically deletes (soft-deletes) a source from every Organization entity that references it, so its data is excluded from future matching and identity views while being retained for possible restorati - [POST /linkIdentities](https://developer.verato.com/apis/organization.openapi/other/linkidentities.md): Forces two source records (each identified by Source + Native ID) into a single common Link ID — used on an exception basis when you have external evidence that two records are the same identity even - [POST /mergeIdentities](https://developer.verato.com/apis/organization.openapi/other/mergeidentities.md): Forces two source records into a common Link ID and converts one of them into a retired/merged state — used to sync a merge that already happened in your source system into the Organization entity. Th - [POST /searchNotifications](https://developer.verato.com/apis/organization.openapi/other/searchnotifications.md): Retrieves queued notification messages describing Link ID assignment changes (triggered by postIdentity, linkIdentities, unlinkIdentities, mergeIdentities, unmergeIdentities, and deleteSourceIdentity) - [POST /unlinkIdentities](https://developer.verato.com/apis/organization.openapi/other/unlinkidentities.md): Forces apart two source records that had previously been matched or linked into the same Link ID, splitting one record out into its own new Link ID. Used to reverse a linkIdentities call or to split a - [POST /unmergeIdentities](https://developer.verato.com/apis/organization.openapi/other/unmergeidentities.md): Re-activates a previously-merged/retired source record and splits it back out into its own new Link ID, reversing the outcome of a mergeIdentities call. Only succeeds if the target source record is cu - [POST /addRelationshipService](https://developer.verato.com/apis/organization.openapi/other/addrelationship.md): Adds a relationship between two entities — for example, an organization and another organization, or an organization and a facility — according to a configured relationship verb (e.g., is a subsidiary - [POST /searchRelationshipsService](https://developer.verato.com/apis/organization.openapi/other/searchrelationships.md): Searches for — and can update — existing relationships involving an Organization entity, using optional filters such as subject Link ID, object Link ID, or relationship verb. Use this to look up which - [POST /deleteRelationshipService](https://developer.verato.com/apis/organization.openapi/other/deleterelationship.md): Deletes a previously defined relationship between two entities. There is no legacy predecessor for the Organization entity — this endpoint, like the entity itself, is new to the platform.