# Create DDS Reference

Creates an EUDR DDS Reference.

Endpoint: POST /organisations/{orgId}/extensions/eudr/references
Version: v2_28
Security: ApiKeyAuth

## Path parameters:

  - `orgId` (string, required)
    The organisation identity

## Header parameters:

  - `contentType` (string, required)

## Request fields (application/json):

  - `type` (string, required)
    This is the type of the DDS Reference. If you are generating a new DDS Reference then set this to NEW. If you are adding an existing Reference then set it to EXISTING.
    Enum: "NEW", "EXISTING"

## Response 201 fields (application/json):

  - `internalReferenceNumber` (string)
    An internal reference number that can be user defined to help identify the DDS Reference. If this is the only identifier provided then it is a mandatory field.

  - `referenceNumber` (string)
    The Reference Number as provided by TracesNT.

  - `verificationNumber` (string)
    The Verification Number provided by Traces NT. It is required if you want to reference the related DDS Statement in another DDS Statement.

  - `hasStatement` (boolean)
    True if there is a DDS Statement associated with this reference number. This happens if it is generated or if there is a Reference Number and Validation Number and the Statement can be retrieved from Traces.

  - `status` (string)
    The status of the Due Diligence Statement.
    Enum: "PENDING", "SUBMITTED", "AVAILABLE", "REJECTED", "CANCELLED", "WITHDRAWN", "ARCHIVED"

  - `operatorUri` (string, required)
    This is the url of the organisation or connection from which the credentials will be used for submission or retrieval of DDS Statements with Traces NT.

  - `id` (string)
    System assigned id field.

  - `createdBy` (string)
    User who created the record.

  - `createdTime` (string)
    Date & Time that the record was created.

  - `updatedBy` (string)
    Last updated by user.

  - `updatedTime` (string)
    Date & Time that the record was last updated.


## Response 400 fields

## Response 401 fields

## Response 403 fields

## Response 429 fields

## Response 500 fields