Validated Party Data (VPD): overview

The Validated Party Data service: verify party information via the GraphQL API.

The Validated Party Data (VPD) service is a GraphQL API that lets you look up and verify party data. The VPD aggregates data from multiple official sources and gives you a reliable, verified view of organisations: legal names, trade names, identifiers, registered addresses and sector information.

What do you use the VPD for?

The VPD is especially valuable when you want to verify that a recipient is correctly registered before sending an invoice or order. Think of validating a Chamber of Commerce number, looking up the official company name or checking a registered address. Because the data is aggregated from multiple sources and verified by eConnect, you save manual lookup effort and reduce the risk of incorrect addressing.

Typical use cases:

  • Party validation before invoicing or placing orders
  • Address enrichment in your CRM or ERP
  • Debtor checks when onboarding new business relations
  • Identifier lookup (KvK, OIN, VAT number, GLN)
GraphQL API

The VPD uses GraphQL instead of REST. This means you request exactly the fields you need in a single query. You don't get superfluous data back and you don't need to call multiple endpoints.

EnvironmentEndpointProductionhttps://vpd.econnect.eu/graphql/v1Acceptancehttps://accp-vpd.econnect.eu/graphql/v1
Authentication

The VPD uses OAuth2 Client Credentials for authentication. Request a token from the eConnect identity server with scope vpd:

POST https://identity.econnect.eu/connect/token
Content-Type: application/x-www-form-urlencoded

grant_type=client_credentials
&client_id=your-client-id
&client_secret=your-client-secret
&scope=vpd

Use the received Bearer token in the Authorization header with every GraphQL request. For the acceptance environment, use accp-identity.econnect.eu.

Core features
FeatureDescriptionAggregated dataParty data from multiple official sources, verified by eConnectGraphQLFlexible queries, retrieve only the fields you needSearchBy identifier, name, postcode, city, country or free search termParty schemaComprehensive structure with identifiers, locations (incl. coordinates), trade names and sector informationPlaygroundGraphical interface for interactive testing without writing code
Getting started

The quickest way to get started with the VPD:

  1. Request VPD API credentials via psb.econnect.eu or contact sales
  2. Obtain an OAuth2 token with scope vpd
  3. Send your first GraphQL query to the VPD endpoint
  4. Or use the VPD Playground to test interactively

Want to learn more about the party data model? Read the article on the VPD schema, or get started straight away with the VPD Playground.

Try the VPD Playground