> ## Documentation Index > Fetch the complete documentation index at: https://sendcloud.dev/llms.txt > Use this file to discover all available pages before exploring further. # Retrieve a pickup > Retrieve information about a specific pickup based on the pickup `id`. ## OpenAPI ````yaml /.openapi/v3/pickups/openapi.yaml get /pickups/{id} openapi: 3.1.0 info: title: Pickups API version: 3.0.0 contact: name: Sendcloud API Support url: https://www.sendcloud.dev email: contact@sendcloud.com description: >- The Pickups API lets you schedule a one-time parcel pickup with supported carriers. license: name: Apache 2.0 url: https://www.apache.org/licenses/LICENSE-2.0.html servers: - url: https://panel.sendcloud.sc/api/v3 description: Sendcloud Production security: [] tags: - name: Pickups description: >- The pickup is a delivery option when a carrier collects parcels at a specific address and time, and then delivers them to the sorting center. paths: /pickups/{id}: parameters: - schema: type: integer name: id in: path required: true description: The `id` of the pickup you want to retrieve. get: tags: - Pickups summary: Retrieve a pickup description: Retrieve information about a specific pickup based on the pickup `id`. operationId: sc-public-v3-scp-get-pickup responses: '200': description: OK content: application/json: schema: type: object properties: data: oneOf: - $ref: '#/components/schemas/brt-pickup-response' - $ref: '#/components/schemas/correos-express-pickup-response' - $ref: '#/components/schemas/correos-pickup-response' - $ref: '#/components/schemas/dhl-de-pickup-response' - $ref: '#/components/schemas/dhl-express-pickup-response' - $ref: '#/components/schemas/dhl-parcel-gb-pickup-response' - $ref: '#/components/schemas/dhl-parcel-iberia-pickup-response' - $ref: '#/components/schemas/dhl-pickup-response' - $ref: '#/components/schemas/dpd-at-pickup-response' - $ref: '#/components/schemas/dpd-pickup-response' - $ref: '#/components/schemas/fedex-response' - $ref: '#/components/schemas/gls-it-response' - $ref: '#/components/schemas/hermes-de-pickup-response' - $ref: '#/components/schemas/poste-it-delivery-pickup-response' - $ref: '#/components/schemas/ups-pickup-response' discriminator: propertyName: carrier_code mapping: brt: $ref: '#/components/schemas/brt-pickup-response' correos: $ref: '#/components/schemas/correos-pickup-response' correos_express: $ref: '#/components/schemas/correos-express-pickup-response' dhl: $ref: '#/components/schemas/dhl-pickup-response' dhl_de: $ref: '#/components/schemas/dhl-de-pickup-response' dhl_express: $ref: '#/components/schemas/dhl-express-pickup-response' dhl_parcel_gb: $ref: '#/components/schemas/dhl-parcel-gb-pickup-response' dhl_parcel_iberia: $ref: >- #/components/schemas/dhl-parcel-iberia-pickup-response dpd: $ref: '#/components/schemas/dpd-pickup-response' dpd_at: $ref: '#/components/schemas/dpd-at-pickup-response' fedex: $ref: '#/components/schemas/fedex-response' gls_it: $ref: '#/components/schemas/gls-it-response' hermes_de: $ref: '#/components/schemas/hermes-de-pickup-response' poste_it_delivery: $ref: >- #/components/schemas/poste-it-delivery-pickup-response ups: $ref: '#/components/schemas/ups-pickup-response' examples: RetrieveDHLExpressPickup: summary: Retrieve a DHL Express pickup value: data: id: 1 address: name: John Doe city: Eindhoven country_code: NL address_line_1: Stadhuisplein house_number: '10' address_line_2: '' postal_code: 5611 EM company_name: Sendcloud email: example@sendcloud.com phone_number: '+310612345678' time_slots: - start_at: '2022-04-06T12:00:00Z' end_at: '2022-04-06T17:00:00Z' items: - quantity: 20 container_type: parcel total_weight: value: '1.00' unit: kg reference: '' special_instructions: '' tracking_number: PRG220406002044 status: CANCELLED created_at: '2022-03-30T09:20:37.957495Z' cancelled_at: '2022-03-30T09:20:45.433367Z' carrier_code: dhl_express contract_id: 10 RetrieveCorreosExpressPickup: summary: Retrieve a Correos Express pickup value: data: id: 1 address: name: John Doe city: Madrid country_code: ES address_line_1: Calle de Dinero house_number: '30' address_line_2: '' postal_code: '28002' company_name: Sendcloud email: example@sendcloud.com phone_number: '+310638404040' time_slots: - start_at: '2022-04-06T12:00:00Z' end_at: '2022-04-06T17:00:00Z' items: - quantity: 20 container_type: parcel total_weight: value: '1.00' unit: kg reference: '' special_instructions: '' tracking_number: '100113932' status: CANCELLED created_at: '2022-03-30T09:20:37.957495Z' cancelled_at: '2022-03-30T09:20:45.433367Z' carrier_code: correos_express contract_id: 10 RetrieveCorreosPickup: summary: Retrieve a Correos pickup value: data: id: 1 address: name: John Doe city: Madrid country_code: ES address_line_1: Calle de Dinero house_number: '30' address_line_2: '' postal_code: '28002' company_name: Sendcloud email: example@sendcloud.com phone_number: '+310638404040' time_slots: - start_at: '2022-04-06T12:00:00Z' end_at: '2022-04-06T17:00:00Z' items: - quantity: 20 container_type: parcel total_weight: value: '1.00' unit: kg reference: '123456' special_instructions: '' tracking_number: '100113932' status: CANCELLED created_at: '2022-03-30T09:20:37.957495Z' cancelled_at: '2022-03-30T09:20:45.433367Z' carrier_code: correos contract_id: 10 RetrievePosteItDeliveryPickup: summary: Retrieve a Poste Italiane Delivery pickup value: data: id: 1 address: name: John Doe city: Roma country_code: IT state_province_code: IT-RM address_line_1: Via Domenico Jachino house_number: '67' address_line_2: '' postal_code: '00144' company_name: Sendcloud email: example@sendcloud.com phone_number: '+3912123732' time_slots: - start_at: '2022-04-06T12:00:00Z' end_at: '2022-04-06T17:00:00Z' items: - quantity: 20 container_type: parcel total_weight: value: '1.00' unit: kg reference: '123456' special_instructions: '' tracking_number: '100113932' status: CANCELLED created_at: '2022-03-30T09:20:37.957495Z' cancelled_at: '2022-03-30T09:20:45.433367Z' carrier_code: poste_it_delivery contract_id: 10 RetrieveGlsItyPickup: summary: Retrieve a GLS Italy pickup value: data: id: 1 address: name: John Doe city: Roma country_code: IT state_province_code: IT-RM address_line_1: Via Domenico Jachino house_number: '67' address_line_2: '' postal_code: '00144' company_name: Sendcloud email: example@sendcloud.com phone_number: '+3912123732' time_slots: - start_at: '2022-04-10T09:00:00Z' end_at: '2022-04-10T12:00:00Z' - start_at: '2022-04-10T14:00:00Z' end_at: '2022-04-10T17:00:00Z' items: - quantity: 20 container_type: parcel total_weight: value: '1.00' unit: kg reference: '123456' special_instructions: '' tracking_number: '100113932' status: CANCELLED created_at: '2022-03-30T09:20:37.957495Z' cancelled_at: '2022-03-30T09:20:45.433367Z' carrier_code: gls_it contract_id: 10 RetrieveFedexPickup: summary: Retrieve a Fedex pickup value: data: id: 100 address: name: John Doe city: Madrid country_code: ES address_line_1: Calle de Dinero house_number: '30' address_line_2: '' postal_code: '28001' company_name: Sendcloud email: example@sendcloud.com phone_number: '0638404040' items: - quantity: 20 container_type: parcel total_weight: value: '1.00' unit: kg reference: '' tracking_number: '791043498202211103183' status: CANCELLED created_at: '2022-03-30T09:20:37.957495Z' cancelled_at: '2022-03-30T09:20:45.433367Z' carrier_code: fedex contract_id: 10 origin_detail: package_location: front building_part: apartment building_part_description: some description company_close_time: '17:00:00' UPSPickup: summary: Retrieve an UPS pickup value: data: id: 1 address: name: John Doe city: London country_code: GB address_line_1: Oxford Street house_number: '1' address_line_2: '' postal_code: W1D 1NN company_name: Sendcloud email: example@sendcloud.com phone_number: '+3912123732' items: - quantity: 2 shipping_option: express container_type: parcel destination_country_code: GB - quantity: 1 shipping_option: standard container_type: pallet destination_country_code: NL time_slots: - start_at: '2022-04-10T13:00:00Z' end_at: '2022-04-10T15:00:00Z' reference: '123456' special_instructions: '' total_weight: value: '1.00' unit: kg tracking_number: '100113932' status: CANCELLED created_at: '2022-03-30T09:20:37.957495Z' cancelled_at: '2022-03-30T09:20:45.433367Z' carrier_code: ups contract_id: 10 RetrieveDhlParcelIberiaPickup: summary: Retrieve a DHL Parcel Iberia pickup value: data: id: 1 address: name: John Doe city: Porto country_code: PT address_line_1: Rua de Justino Teixeira house_number: '640' address_line_2: '' postal_code: 4300-277 company_name: Sendcloud email: example@sendcloud.com phone_number: '+310638404040' time_slots: - start_at: '2022-04-06T12:00:00Z' end_at: '2022-04-06T17:00:00Z' items: - quantity: 20 container_type: parcel total_weight: value: '1.00' unit: kg reference: '' special_instructions: '' tracking_number: '100113932' status: CANCELLED created_at: '2022-03-30T09:20:37.957495Z' cancelled_at: '2022-03-30T09:20:45.433367Z' carrier_code: dhl_parcel_iberia contract_id: 10 RetrieveHermesGermanyPickup: summary: Retrieve a Hermes Germany pickup value: data: id: 1 address: name: John Doe city: Eindhoven country_code: NL address_line_1: Stadhuisplein house_number: '10' address_line_2: '' postal_code: 5611 EM company_name: Sendcloud email: example@sendcloud.com phone_number: '+310612345678' time_slots: - start_at: '2022-04-06T09:00:00Z' end_at: '2022-04-06T12:00:00Z' items: - quantity: 20 container_type: parcel total_weight: value: '1.00' unit: kg reference: '' special_instructions: '' tracking_number: PRG220406002044 status: CANCELLED created_at: '2022-03-30T09:20:37.957495Z' cancelled_at: '2022-03-30T09:20:45.433367Z' carrier_code: hermes_de contract_id: 10 RetrieveDHLParcelGBPickup: summary: Retrieve an DHL Parcel GB pickup value: data: id: 1 address: name: John Doe city: London country_code: GB address_line_1: Oxford Street house_number: '1' address_line_2: '' postal_code: W1D 1NN company_name: Sendcloud email: example@sendcloud.com phone_number: '+3912123732' time_slots: - start_at: '2022-04-10T13:00:00Z' end_at: '2022-04-10T15:00:00Z' reference: '123456' special_instructions: '' total_weight: value: '1.00' unit: kg customer_account_number: '12345' trading_location_id: XYZ123456 tracking_number: '100113932' status: CANCELLED created_at: '2022-03-30T09:20:37.957495Z' cancelled_at: '2022-03-30T09:20:45.433367Z' carrier_code: dhl_parcel_gb contract_id: 10 RetrieveBrtPickup: summary: Retrieve a BRT pickup value: data: id: 1 address: name: John Doe city: Roma country_code: IT state_province_code: IT-RM address_line_1: Via Domenico Jachino house_number: '67' address_line_2: '' postal_code: '00144' company_name: Sendcloud email: example@sendcloud.com phone_number: '+3912123732' time_slots: - start_at: '2022-04-10T09:00:00Z' end_at: '2022-04-10T12:00:00Z' - start_at: '2022-04-10T14:00:00Z' end_at: '2022-04-10T17:00:00Z' items: - quantity: 20 container_type: parcel total_weight: value: '1.00' unit: kg reference: '123456' special_instructions: '' tracking_number: '100113932' status: CANCELLED created_at: '2022-03-30T09:20:37.957495Z' cancelled_at: '2022-03-30T09:20:45.433367Z' carrier_code: brt contract_id: 10 RetrieveDHLPickup: summary: Retrieve a DHL pickup value: data: id: 1 address: name: John Doe city: Eindhoven country_code: NL address_line_1: Stadhuisplein house_number: '10' address_line_2: '' postal_code: 5611 EM company_name: Sendcloud email: example@sendcloud.com phone_number: '+310612345678' time_slots: - start_at: '2022-04-06T09:00:00Z' end_at: '2022-04-06T12:00:00Z' items: - quantity: 20 container_type: parcel total_weight: value: '1.00' unit: kg - quantity: 2 container_type: pallet total_weight: value: '10.00' unit: kg reference: '' special_instructions: '' tracking_number: '1025216' status: CANCELLED created_at: '2022-03-30T09:20:37.957495Z' cancelled_at: '2022-03-30T09:20:45.433367Z' carrier_code: dhl contract_id: 1 RetrieveDPDPickup: summary: Retrieve a DPD pickup value: data: id: 1 address: name: John Doe city: Berlin country_code: DE address_line_1: Hannoversche Str. house_number: 5B address_line_2: '' postal_code: 10115 company_name: Sendcloud email: example@sendcloud.com phone_number: '+4975327149698' time_slots: - start_at: '2022-04-06T12:00:00Z' end_at: '2022-04-06T17:00:00Z' items: - quantity: 20 container_type: parcel total_weight: value: '1.00' unit: kg reference: '' special_instructions: '' tracking_number: '100113932' status: CANCELLED created_at: '2022-03-30T09:20:37.957495Z' cancelled_at: '2022-03-30T09:20:45.433367Z' carrier_code: dpd contract_id: 10 RetrieveDhlDePickup: summary: Retrieve a DHL DE pickup value: data: id: 1 address: name: John Doe city: Eindhoven country_code: NL address_line_1: Stadhuisplein house_number: '10' address_line_2: '' postal_code: 5611 EM company_name: Sendcloud email: example@sendcloud.com phone_number: '+310612345678' time_slots: - start_at: '2022-04-06T09:00:00Z' end_at: '2022-04-06T12:00:00Z' items: - quantity: 5 container_type: parcel total_weight: value: '2.00' unit: kg reference: '' special_instructions: '' tracking_number: '1025216' status: ANNOUNCING created_at: '2022-03-30T09:20:37.957495Z' cancelled_at: null carrier_code: dhl_de contract_id: null '404': description: Not Found content: application/json: schema: $ref: '#/components/schemas/errors' examples: NotFound: summary: Not Found value: errors: - status: '404' code: not_found detail: No Pickup matches the given query. security: - HTTPBasicAuth: [] - OAuth2ClientCreds: [] components: schemas: brt-pickup-response: title: BRT Pickup Object type: object allOf: - $ref: '#/components/schemas/base-pickup-request' - properties: carrier_code: type: string enum: - brt description: Pickup carrier code selected by the user. address: $ref: '#/components/schemas/pickup-address-state-province-required' description: Pickup address information. time_slots: $ref: '#/components/schemas/time-slot-list-end-at-required' correos-express-pickup-response: title: Correos Express Pickup Object type: object allOf: - $ref: '#/components/schemas/base-pickup-response' - properties: carrier_code: type: string enum: - correos_express description: Pickup carrier code selected by the user. address: $ref: '#/components/schemas/pickup-address-phone-number-required' description: Pickup address information. time_slots: $ref: '#/components/schemas/time-slot-list-end-at-required' correos-pickup-response: title: Correos Express Pickup Object type: object allOf: - $ref: '#/components/schemas/base-pickup-response' - properties: carrier_code: type: string enum: - correos description: Pickup carrier code selected by the user. address: $ref: '#/components/schemas/pickup-address-phone-number-required' description: Pickup address information. time_slots: $ref: '#/components/schemas/time-slot-list-end-at-required' description: Scheduled time slot for the pickup. dhl-de-pickup-response: title: DHL Germany Pickup Object type: object allOf: - $ref: '#/components/schemas/base-pickup-response' - properties: carrier_code: type: string enum: - dhl_de description: Pickup carrier code selected by the user. time_slots: $ref: '#/components/schemas/time-slot-list' description: Scheduled time slot for the pickup. items: type: array items: $ref: '#/components/schemas/dhl-de-pickup-item' description: Items to be picked up. dhl-express-pickup-response: title: DHL Express Pickup Object type: object allOf: - $ref: '#/components/schemas/base-pickup-response' - properties: carrier_code: type: string enum: - dhl_express description: Pickup carrier code selected by the user. address: $ref: '#/components/schemas/pickup-address-phone-number-required' description: Pickup address information. time_slots: $ref: '#/components/schemas/time-slot-list-end-at-required' dhl-parcel-gb-pickup-response: title: DHL Parcel GB Pickup Object type: object allOf: - $ref: '#/components/schemas/base-pickup-response' - properties: carrier_code: type: string enum: - dhl_parcel_gb description: Pickup carrier code selected by the user. dhl-parcel-iberia-pickup-response: title: DHL Parcel Iberia Pickup Object type: object allOf: - $ref: '#/components/schemas/base-pickup-response' - properties: carrier_code: type: string enum: - dhl_parcel_iberia description: Pickup carrier code selected by the user. time_slots: $ref: '#/components/schemas/time-slot-list-end-at-required' dhl-pickup-response: title: DHL Pickup Object type: object allOf: - $ref: '#/components/schemas/base-pickup-response' - properties: carrier_code: type: string enum: - dhl description: Pickup carrier code selected by the user. time_slots: $ref: '#/components/schemas/time-slot-list-end-at-required' description: Scheduled time slot for the pickup. items: type: array items: $ref: '#/components/schemas/dhl-pickup-item' description: Items to be picked up. dpd-at-pickup-response: title: DPD AT Pickup Object type: object allOf: - $ref: '#/components/schemas/base-pickup-response' - properties: carrier_code: type: string enum: - dpd_at description: Pickup carrier code selected by the user. time_slots: $ref: '#/components/schemas/time-slot-list-end-at-required' description: Scheduled time slot for the pickup. items: type: array items: $ref: '#/components/schemas/dpd-at-pickup-item' description: Items to be picked up. dpd-pickup-response: title: DPD Pickup Object type: object allOf: - $ref: '#/components/schemas/base-pickup-response' - properties: carrier_code: type: string enum: - dpd description: Pickup carrier code selected by the user. fedex-response: title: Fedex Pickup Object type: object allOf: - $ref: '#/components/schemas/base-pickup-response' - properties: carrier_code: type: string enum: - fedex description: Pickup carrier code selected by the user. address: $ref: '#/components/schemas/pickup-address-phone-number-required' description: Pickup address information. origin_detail: $ref: '#/components/schemas/fedex-origin-detail' gls-it-response: title: GLS Italy Object type: object allOf: - $ref: '#/components/schemas/base-pickup-response' - properties: carrier_code: type: string enum: - gls_it description: Pickup carrier code selected by the user. address: $ref: '#/components/schemas/pickup-address-state-province-required' description: Pickup address information. time_slots: $ref: '#/components/schemas/time-slot-list-end-at-required' description: > Scheduled time slots for the pickup. One or two time slots can be defined, one for the morning and one for the afternoon. minItems: 1 maxItems: 2 hermes-de-pickup-response: title: Hermes Germany Pickup Response type: object allOf: - $ref: '#/components/schemas/base-pickup-response' - type: object properties: carrier_code: type: string enum: - hermes_de description: Pickup carrier code selected by the user. time_slots: $ref: '#/components/schemas/time-slot-list-end-at-required' poste-it-delivery-pickup-response: title: Poste Italiane Delivery Pickup request type: object allOf: - $ref: '#/components/schemas/base-pickup-response' - properties: carrier_code: type: string enum: - poste_it_delivery description: Pickup carrier code selected by the user. address: $ref: '#/components/schemas/pickup-address-state-province-required' description: Pickup address information. ups-pickup-response: title: UPS Pickup Object type: object allOf: - $ref: '#/components/schemas/base-pickup-response' - properties: carrier_code: type: string enum: - ups description: Pickup carrier code selected by the user. address: $ref: '#/components/schemas/pickup-address-phone-number-required' description: Pickup address information. time_slots: $ref: '#/components/schemas/time-slot-list-end-at-required' items: type: array items: $ref: '#/components/schemas/ups-pickup-item' description: Items to be picked up. errors: title: Errors type: object description: A standardized format for errors in JSON:API responses. properties: errors: type: - array - object items: type: object allOf: - $ref: '#/components/schemas/ErrorObject' required: - status - code - detail base-pickup-request: title: Base Pickup request type: object properties: time_slots: $ref: '#/components/schemas/time-slot-list' minItems: 1 maxItems: 1 items: type: array items: $ref: '#/components/schemas/base-pickup-item' description: Items scheduled to be picked up. minItems: 1 reference: type: string description: Reference number for your administration. minLength: 0 special_instructions: type: string description: Special instructions for the pickup driver. carrier_code: type: string example: dhl_express description: Pickup carrier code selected by the user. contract_id: type: - integer - 'null' description: Contract ID you want to use for the pickup request. quantity: type: integer minimum: 1 description: Number of parcels to pick up. total_weight: $ref: '#/components/schemas/str-weight' description: Total weight in kilograms. address: $ref: '#/components/schemas/pickup-address' description: Pickup address information. required: - time_slots - quantity - total_weight - carrier_code - address pickup-address-state-province-required: title: Pickup Address Object type: object description: Pickup Address object allOf: - $ref: '#/components/schemas/pickup-address' - properties: country_code: type: string example: IT description: >- Country code of the pickup place according to ISO 3166-1 alpha-2. minLength: 1 state_province_code: type: string minLength: 1 example: IT-RM description: >- State code of the pickup place according to ISO 3166-2. This field is required for certain countries. See [international shipping](/docs/shipments/international-shipping#required-fields-for-international-shipments) for details. required: - name - address_line_1 - postal_code - city - country_code - state_province_code time-slot-list-end-at-required: title: Time Slot List type: array description: >- Scheduled time slots for the pickup. Note that most carriers only support a single time slot. items: type: object allOf: - $ref: '#/components/schemas/time-slot-end-at-required' base-pickup-response: title: Base Pickup Object type: object properties: id: type: integer format: int64 minimum: 1 description: Unique identifier of the pickup. carrier_code: type: string example: dhl_express description: Pickup carrier code selected by the user. time_slots: $ref: '#/components/schemas/time-slot-list' description: Scheduled time slots for the pickup minItems: 1 items: type: array items: $ref: '#/components/schemas/base-pickup-item' description: Items scheduled to be picked up. minItems: 1 reference: type: string description: Reference number for your administration. minLength: 0 special_instructions: type: string description: Special instructions for the pickup driver. minLength: 0 tracking_number: type: string minLength: 0 status: type: string enum: - CREATED - CANCELLED - FAILED - ANNOUNCING created_at: type: string format: date-time description: ISO 8601 DateTime at which the pickup is created. cancelled_at: type: - string - 'null' format: date-time description: ISO 8601 DateTime at which the pickup is cancelled. contract_id: type: integer description: Id of the contract that is used to create the pickup. address: $ref: '#/components/schemas/pickup-address' description: Pickup address information. pickup-address-phone-number-required: title: Pickup Address Object type: object description: Pickup Address object allOf: - $ref: '#/components/schemas/pickup-address' - properties: phone_number: type: string description: Phone number of the contact person in the E.164 format. required: - name - address_line_1 - postal_code - city - country_code - phone_number time-slot-list: title: Time Slot List type: array description: >- Scheduled time slots for the pickup. Note that most carriers only support a single time slot. items: type: object allOf: - $ref: '#/components/schemas/time-slot' dhl-de-pickup-item: title: DHL DE Pickup Item Object type: object description: Information about the items to be picked up. allOf: - $ref: '#/components/schemas/base-pickup-item' required: - quantity dhl-pickup-item: title: DHL Pickup Item Object type: object description: Provides the information about the items to be picked up. allOf: - $ref: '#/components/schemas/base-pickup-item' - properties: container_type: type: string example: parcel description: Type of containers to be picked up. enum: - parcel - pallet required: - quantity - container_type - total_weight dpd-at-pickup-item: title: DPD AT Pickup Item Object type: object description: Provides the information about the items to be picked up. allOf: - $ref: '#/components/schemas/base-pickup-item' - properties: container_type: type: string example: parcel description: Type of containers to be picked up. enum: - parcel - pallet required: - quantity - container_type - total_weight fedex-origin-detail: title: Fedex Origin Detail Object description: >- Descriptive data about the origin of the shipment being picked up by FedEx. type: object properties: package_location: description: >- Provides a location description where the courier/driver will pick up the package. type: string enum: - front - none - rear - side building_part: description: Describe package location building part. type: string enum: - apartment - building - department - floor - room - suite building_part_description: description: Additional description of package pickup location. type: string company_close_time: description: >- Identifies the latest time at which the driver can gain access to pick up the package. type: string format: time example: 17:00:00Z required: - package_location - building_part - company_close_time ups-pickup-item: title: UPS Pickup Item Object type: object description: Information about the items to be picked up. allOf: - $ref: '#/components/schemas/base-pickup-item' - properties: container_type: type: string example: parcel description: Type of containers to be picked up. enum: - parcel - pallet destination_country_code: type: string example: GB minLength: 2 maxLength: 2 description: Destination country code. shipping_option: type: string example: express description: Shipping option for the pickup. enum: - standard - express - express_saver required: - quantity - destination_country_code - container_type - shipping_option - total_weight ErrorObject: title: Error type: object description: Error in a JSON:API error format properties: id: type: string description: A unique identifier for the error. links: type: object description: >- A set of hyperlinks that provide additional information about the error. properties: about: type: string description: A URL that provides additional information about the error. status: type: string format: int32 description: The HTTP status code of the error. minLength: 1 code: type: string description: A unique error code for the error, in snake case format. minLength: 1 enum: - unknown_field - invalid - forbidden - invalid_choice - min_value - 'null' - not_found - required - not_a_list - non_field_errors - authentication_failed - validation_error - parcel_announcement_error title: type: string description: A short, human-readable summary of the error. minLength: 1 detail: type: string description: A human-readable explanation of the error. minLength: 1 source: type: object description: >- An object that identifies the source of the error within the request payload. properties: pointer: type: string description: >- A `JSON` pointer to the location of the error within the request payload. parameter: type: string description: The name of the `query` parameter that caused the error. header: type: string description: The name of the `header` parameter that caused the error. meta: type: object description: Additional metadata about the error. base-pickup-item: title: Pickup Item Object type: object description: Information about the items to be picked up. properties: quantity: type: integer minimum: 1 description: Number of items to pick up. container_type: type: string example: parcel description: Type of containers to be picked up. enum: - parcel total_weight: $ref: '#/components/schemas/str-weight' description: Total weight in kilograms. required: - quantity - container_type - total_weight str-weight: title: Weight type: object description: Weight in the specified unit properties: value: type: string description: Weight value example: '14.5' unit: $ref: '#/components/schemas/weight-units' required: - value - unit pickup-address: title: Pickup Address Object type: object description: Pickup Address object allOf: - $ref: '#/components/schemas/address' - properties: po_box: type: - string - 'null' description: Code required in case of PO Box or post locker delivery readOnly: true required: - name - address_line_1 - postal_code - city - country_code time-slot-end-at-required: title: Time Slot Object type: object properties: start_at: type: string format: date-time description: Scheduled pickup time in ISO 8601 DateTime format. end_at: type: string format: date-time description: >- ISO 8601 DateTime of the pickup location close time. This could be useful in case the pickup is delayed. time-slot: title: Time Slot Object type: object properties: start_at: type: string format: date-time description: Scheduled pickup time in ISO 8601 DateTime format. end_at: type: - string - 'null' format: date-time description: >- ISO 8601 DateTime of the pickup location close time. This could be useful in case the pickup is delayed. weight-units: type: string title: Mass Units Object enum: - kg - g - lbs - oz example: g address: title: Address Object type: object description: Sendcloud Address object properties: name: type: string example: John Doe description: Name of the person associated with the address minLength: 1 company_name: type: string example: Sendcloud description: Name of the company associated with the address address_line_1: type: string example: Stadhuisplein description: First line of the address house_number: type: string example: '50' description: House number of the address address_line_2: type: string description: Additional address information, e.g. 2nd level example: Apartment 17B postal_code: type: string example: 1013 AB description: Zip code of the address minLength: 1 city: type: string example: Eindhoven description: City of the address minLength: 1 po_box: type: - string - 'null' description: Code required in case of PO Box or post locker delivery state_province_code: type: string example: IT-RM description: >- The character state code of the customer represented as ISO 3166-2 code. This field is required for certain countries. See [international shipping](/docs/shipments/international-shipping#required-fields-for-international-shipments) for details. country_code: type: string example: NL description: The country code of the customer represented as ISO 3166-1 alpha-2 minLength: 1 email: type: string format: email example: johndoe@gmail.com description: Email address of the person associated with the address phone_number: type: string example: '+319881729999' description: Phone number of the person associated with the address securitySchemes: HTTPBasicAuth: type: http description: >- Basic Authentication using API key and secrets is currently the main authentication mechanism. scheme: basic OAuth2ClientCreds: type: oauth2 description: >- OAuth2 is a standardized protocol for authorization that allows users to share their private resources stored on one site with another site without having to provide their credentials. OAuth2 Client Credentials Grant workflow. This workflow is typically used for server-to-server interactions that require authorization to access specific resources. flows: clientCredentials: tokenUrl: https://account.sendcloud.com/oauth2/token/ scopes: api: Default OAuth scope required to access Sendcloud API. ````