# Retrieve DDS Reference List

Gets the list of DDS References.

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

## Path parameters:

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

## Query parameters:

  - `internalReference` (string)
    The internal reference number for the DDS Reference.

  - `status` (string)
    Get the DDS references with the provided status.
    Enum: "PENDING", "SUBMITTED", "AVAILABLE", "REJECTED", "CANCELLED", "WITHDRAWN", "ARCHIVED"

  - `sourceResourceType` (string, required)
    This is the resource type of the source.
    Enum: "DELIVERY", "ITEM", "PRODUCT", "PURCHASE_ORDER"

  - `size` (integer)
    The number of elements to return in each page. Minimum value must be 1, defaults to 20.

  - `page` (integer)
    The pageNo to return. (Zero-based)

## Response 200 fields (application/json):

  - `content` (array, required)

  - `content.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.

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

  - `content.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.

  - `content.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.

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

  - `content.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.

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

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

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

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

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

  - `page` (object, required)

  - `page.size` (integer, required)

  - `page.totalElements` (integer, required)

  - `page.totalPages` (integer, required)


## Response 401 fields

## Response 403 fields

## Response 429 fields

## Response 500 fields