---
title: "Get Accounts"
method: GET
path: "/v4/shippingAccounts/dpdie"
tags: ["Shipping Accounts"]
---

# Get Accounts

`GET /v4/shippingAccounts/dpdie`

## Request

- Base URL: `https://api.intersoftsapient.net`
- URL: `https://api.intersoftsapient.net/v4/shippingAccounts/dpdie`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://authentication.intersoftsapient.net/connect/token`

Provides a list of DPD Ireland shipping accounts only.
<br />Information about the account number, account type, and contact details is included in the response.

## Query parameters

- `searchTerm` string
- `pageSize` integer
- `pageNumber` integer
- `sortBy` 'Name' | 'Alias' | 'LastModified' | 'CarrierAccountNumber': Sort By
- `sortDir` 'Ascending' | 'Descending': Order Direction

## Response `200`

Returns a paged list of shipping accounts for the given carrier.

- DpdIrelandShippingAccountShippingAccountsPagedResponse: The paged response containing the entities for the requested page only, and the total number available.
  - `ShippingAccounts` DpdIrelandShippingAccount[], required: An array containing the shipping accounts associated with the shipping location that match the query parameters specified in the request.
    - `ShippingAccountId` string, uuid, required: A unique identifier for each shipping account assigned by the system **(ShippingAccountId)**, allowing for efficient reference and management of individual accounts within the system.
    - `CarrierCode` string, required: A unique identifier for the carrier associated with the shipping account. This code is typically alphanumeric and helps in identifying the specific carrier linked to the shipping account.
    - `AccountNumber` string, required: The number assigned to the shipping account by the carrier, typically used for tracking shipments and billing purposes.<br/><br/><i><b>Note:</b> This is the account number assigned by the DPD IE.</i>
    - `AccountType` 'Sandbox' | 'Production', required: Indicates whether the account is set up as a "sandbox" or "production" account. A **Sandbox** account is for testing and development, while a **Production** account is used for live shipments and transactions.
    - `AccountName` string, required: The official name of the shipping account as designated by the user or organisation, aiding in easy identification and reference of accounts.<br/><br/><i><b>Note:</b> By default, this value is set to the customer name if not provided in the request. The Account Name will appear on DPD Ireland's tracking page and in notifications sent to the receiver if the Shipper Company Name is not provided.</i>
    - `AccountAlias` string, required: A unique, user-defined name for the shipping account, providing a convenient way to reference the account in a more memorable manner.
    - `AccountStatus` string, required: The current status of the shipping account, which could denote whether it is active, inactive, or suspended, helping users understand the account's usability.
    - `ContactName` string, required: The name of the primary contact person for the shipping account, facilitating communication regarding shipping and account-related matters.
    - `Username` string, required: Username provided by DPD Ireland
    - `ContactNumber` string, tel, required: The phone number associated with the shipping account's primary contact person, facilitating communication regarding shipping inquiries, account management, and issue resolution. <br /> <br />***Note**: Characters like +, /, -, or space are supported.*
    - `LastUpdatedBy` string, required: The identifier (such as a username or system account) of the individual or system that last modified the shipping account information, ensuring accountability.
    - `LastUpdatedDateUtc` string, date-time, required: A timestamp indicating the last time the shipping account details were updated, formatted in Coordinated Universal Time (UTC).
  - `TotalCount` integer, required: An integer representing the total number of shipping accounts that match the query parameters sent in the request, giving users a quick overview of how many accounts are linked to their operations.

## Other responses

- `400`: Invalid request response.
- `401`: Unauthorized
- `403`: Forbidden
- `500`: Internal Server Error

---

[API](https://skmtc.dev/intersoftsapient/apis/dpd-ireland.md) - [All operations](https://skmtc.dev/intersoftsapient/apis/dpd-ireland/llms.txt) - [OpenAPI document](https://skmtc.dev/intersoftsapient/apis/dpd-ireland/revisions/58ae586d6634?raw)