Each entity that takes out an DDEX Implementation Licence will be allocated a DDEX Party Identifier (DPID) in accordance with the DPID standard. The allocation of DPIDs is undertaken through an automated system at dpid.ddex.net.
To be allocated a DPID applicants should complete and submit an application form at dpid.ddex.net. The application form requires the applicant to accept the terms of the DDEX Implementation Licence. The system will then automatically allocate a DPID and send this data to the applicant.
As part of the registration the applicant will receive, in the same email that includes the DPID data, credentials to enable the applicant to access the DPID registry. This access will enable the applicant to:
Applicants that have been allocated one or more DPIDs must keep their record(s) up to date by logging into the system and changing any relevant information. This can be done using the web interface.
When logging into dpid.ddex.net with the username and password provided, the applicant can view the complete DPID registry or search for a specific company or DPID. It is also possible to export the complete registry in PDF or XML format.
The only data about an entity that have been allocated a DPID that is shown to other entities are:
The individual DPID;
The name of the entity to whom the DPID has been allocated; and
The street address of the entity to whom the DPID has been allocated.
When searching for a DPID, please use the human readable syntax, e.g. “PA-DPIDA-2014122301-Q” and not the form used in DDEX messages which is “PADPIDA2014122301Q” or in a form that just uses the string between “PADPIDA-“ and the last two characters, here “-Q”.
Using the web interface
Applicants that have been allocated a DPID can request additional DPIDs.
When doing so, the applicant must choose a different “entity name” in order to distinguish that entity from any other existing entities associated with the applicant and thus distinguish the various DPIDs allocated to such entities. For example:
Company X (Video Service); and
Company X (Audio Service); or
Company Y (Copyright Department); and
Company Y (Royalty Department).
Using the API
Some companies offer DDEX messaging services to their clients. This includes, or example, aggregators who send and receive DDEX messages on behalf of record companies.
Entities that wish to allocate DPIDs on behalf of their clients must contact the DDEX Secretariat at firstname.lastname@example.org so that it can be determined if that entity can be authorised to benefit from this feature of the DPID registry.
The information available through the look up service is also available as XML data and can be downloaded by accessing the registry’s API at the following URLs:
https://dpid.ddex.net/api/v2/xml-download?token=XXXto receive a list of the DPID records allocated to the applicant; and
https://dpid.ddex.net/api/v2/xml-download/all?token=XXXto receive a list of all DPID records in the DPID registry.
XXX is user-specific and details on how to generate them can be found at the bottom of this page. The system replies automatically with the XML formatted copy of the DPID registry. The XSD defining the syntax of the file is provided at http://ddex-standards.net/xml/dpid/20/dpid.xsd.
For any applicant to be able to access any features of the API, the applicant must have a valid token. This is generated by the user interface at the point at which the applicant logs in. Please navigate to “My Profile”.
Please click “generate token” and then “update user details”. Tokens will expire after 60 days.