openapi: 3.0.0
info:
    title: Tracking
    description: ''
    version: 1.0.0
    x-ibm-name: tracking-service-v1
    x-pathalias: tracking-api-1.0.0
    x-ibm-languages:
        title:
            fr: Suivie
    x-ibm-summary: ''
servers:
    -
        url: 'https://api.canadapost-postescanada.ca/prod/devportal-portaildesdeveloppeurs/tracking/v1'
paths:
    '/pins/{pinNumber}/summaries':
        get:
            tags:
                - Tracking
            summary: 'Tracking Summary (PIN)'
            description: 'Returns the most recent delivery event for a package, including confirmation of package delivery. The package is identified using PIN.'
            x-ibm-languages:
                summary:
                    fr: 'Résumé du suivi (Pin)'
                description:
                    fr: "Retourne l'événement de livraison le plus récent pour un colis, y compris la confirmation de la livraison du colis.Le colis est identifié à l'aide d'un code PIN."
            parameters:
                -
                    $ref: '#/components/parameters/pinNumber'
                -
                    $ref: '#/components/parameters/platformID'
                -
                    $ref: '#/components/parameters/language'
            responses:
                200:
                    $ref: '#/components/responses/200-trackSummary'
                400:
                    $ref: '#/components/responses/400-track'
                401:
                    $ref: '#/components/responses/401'
                403:
                    $ref: '#/components/responses/403'
                404:
                    $ref: '#/components/responses/404'
                500:
                    $ref: '#/components/responses/500'
                503:
                    $ref: '#/components/responses/503'
                504:
                    $ref: '#/components/responses/504'
            operationId: trackingSummaryPin
    '/dncs/{dncNumber}/summaries':
        get:
            tags:
                - Tracking
            summary: 'Tracking Summary (DNC)'
            description: 'Returns the most recent delivery event for a package, including confirmation of package delivery. The package is identified using DNC.'
            x-ibm-languages:
                description:
                    fr: "Retourne l'événement de livraison le plus récent pour un colis, y compris la confirmation de la livraison du colis.Le colis est identifié à l'aide de DNC."
                summary:
                    fr: 'Résumé du suivi (Dnc)'
            parameters:
                -
                    $ref: '#/components/parameters/dncNumber'
                -
                    $ref: '#/components/parameters/platformID'
                -
                    $ref: '#/components/parameters/language'
            responses:
                200:
                    $ref: '#/components/responses/200-trackSummary'
                400:
                    $ref: '#/components/responses/400-track'
                401:
                    $ref: '#/components/responses/401'
                403:
                    $ref: '#/components/responses/403'
                404:
                    $ref: '#/components/responses/404'
                500:
                    $ref: '#/components/responses/500'
                503:
                    $ref: '#/components/responses/503'
                504:
                    $ref: '#/components/responses/504'
            operationId: trackingSummaryDNC
    /refs/summaries:
        get:
            tags:
                - Tracking
            summary: 'Tracking Summary (Ref)'
            description: 'Returns the most recent delivery event for a package, including confirmation of package delivery. The package is identified using reference parameters.'
            x-ibm-languages:
                description:
                    fr: "Retourne l'événement de livraison le plus récent pour un colis, y compris la confirmation de la livraison du colis.Le paquet est identifié à l'aide de paramètres de référence."
                summary:
                    fr: 'Résumé du suivi (Ref)'
            parameters:
                -
                    $ref: '#/components/parameters/platformID'
                -
                    name: customer-number
                    in: query
                    description: "The customer-number query parameter value can be either:\n\n- The customer number for the organization initiating the shipment, or\n- The customer number of the customer on whose behalf the parcel was mailed.\n\nIf the customer-number query parameter is not specified, the customer number of the user that was used to authenticate this request will be used.\n\nIf you ship parcels on behalf of other customers and you specify their customer number in the request, only tracking results of parcels which were mailed \"on behalf of\" that customer (and that match the other query parameter criteria) are returned.\n\nIf you ship parcels on behalf of other customers and you specify your own customer number, you will receive tracking results for any parcels you shipped for yourself, including all parcels you shipped for any other customers (providing it also matches the other query parameter criteria)."
                    x-ibm-languages:
                        description:
                            fr: "La valeur du paramètre de requête du customerNumber peut être:\n\n- le numéro du client pour l'organisation qui entreprend l'expédition;\n- le numéro du client pour le client au nom duquel le colis a été expédié.\n\nSi le paramètre de requête pour le numéro du client n'est pas précisé, le numéro du client de l'utilisateur qui a été utilisé pour authentifier cette demande sera utilisé.\n\nSi vous expédiez des colis au nom d'autres clients et que vous précisez leur numéro de client dans la demande, seuls les résultats de repérage des colis qui ont été expédiés au nom de ce client (et qui correspondent aux autres critères des paramètres de requête) sont renvoyés.\n\nSi vous expédiez des colis au nom d'autres clients et que vous précisez votre propre numéro de client, vous recevrez des résultats de repérage pour tous les colis que vous avez expédiés vous-même, y compris tous les colis que vous avez expédiés au nom d'autres clients (à condition qu'ils correspondent aux autres critères des paramètres de requête)."
                    schema:
                        type: string
                        maxLength: 10
                    example: 1027821
                -
                    name: reference-number
                    in: query
                    description: "The value assigned to a parcel by the shipper at the time the shipment was created. This value may have been specified in either \"customer-ref1\" or \"customer-ref2\" fields of the submitted parcel.\n\nThe Get Tracking Summary service only returns tracking results for parcels that match the reference-number query parameter value."
                    x-ibm-languages:
                        description:
                            fr: "La valeur attribuée à un colis par l'expéditeur lorsque l'envoi a été créé. Cette valeur peut avoir été indiquée dans les champs « customer-ref1 » ou « customer-ref2 » du colis soumis.\n\nLe service Obtenir un résumé de repérage fournit seulement les résultats du repérage pour les colis qui correspondent à la valeur du paramètre de requête referenceNumber."
                    required: true
                    schema:
                        type: string
                        maxLength: 35
                    example: SPQFZT1V6V4
                -
                    name: destination-postal-code
                    in: query
                    description: "The destination Postal Code, zip code or postal identifier for the parcel in its destination country. This is the value that would be supplied in the element \"postalZipCode\" in a create shipment request.\n\nFormat is any of the following:\n\n- 6-character alphanumeric for Canada (A9A9A9).\n- 5-digit or 5-4 digit numeric code for US.\n- Up to 14 characters (free format) for other countries.\n\nWhen present, the Get Tracking Summary service only returns tracking results for parcels that match destination-postal-code value.\n\n**Note:** For zip codes in the form 99999-9999, only the first 5 digits are used in the matching."
                    x-ibm-languages:
                        description:
                            fr: "Code postal de destination, code ZIP ou identificateur postal du colis dans son pays de destination. Il s'agit de la valeur qui serait fournie pour l'élément « postalZipCode » dans une demande de création d'un envoi.\n\nLe format est l'un des suivants :\n\n- Six caractères alphanumériques pour le Canada [A9A9A9].\n- Code numérique à cinq chiffres ou à neuf chiffres [cinq chiffres suivis de quatre autres chiffres] pour les États-Unis.\n- Jusqu'à 14 caractères (tout format) pour les autres pays.\n\nLorsqu'il est offert, le service « Obtenir un résumé du repérage » fournit seulement les résultats du repérage pour les colis correspondant à la valeur de destinationPostalCode.\n\n**Nota :** Pour les codes ZIP dont le format est « 99999-9999 », seulement les cinq premiers caractères sont utilisés dans la mise en correspondance."
                    schema:
                        type: string
                        anyOf:
                            -
                                pattern: '^[A-Z]\d[A-Z]\d[A-Z]\d$'
                            -
                                pattern: '^\d{5}(-\d{4})?$'
                            -
                                pattern: '^.{1,14}$'
                        minLength: 1
                        maxLength: 14
                    example: M9W1J1
                -
                    name: mailing-date-from
                    in: query
                    description: "The combination of mailing-date-from and mailing-date-to query parameters defines a range of dates for when the parcel(s) in question were shipped.\n\nFormat is: yyyy-mm-dd\n\nThe mailing-date-from value cannot be earlier than two calendar months from the current date."
                    x-ibm-languages:
                        description:
                            fr: "La combinaison des paramètres de requête mailingDateFrom et mailingDateTo définit une plage de dates pendant laquelle les colis en question ont été expédiés.\n\nLe format est : aaaa-mm-jj.\n\nLa valeur mailingDateFrom ne peut pas être antérieure à deux mois civils à partir de la date actuelle."
                    required: true
                    schema:
                        type: string
                        format: date
                    example: '2024-01-26'
                -
                    name: mailing-date-to
                    in: query
                    description: "When executing a request by reference parameter, both the mailing-date-from and mailing-date-to query parameters are mandatory and must be included.\n\nThe Get Tracking Summary service only returns tracking results for parcels that were shipped within the range of dates specified by the mailing-date-from and mailing-date-to query parameters."
                    x-ibm-languages:
                        description:
                            fr: "Lorsque vous exécutez une demande avec un paramètre de référence, les paramètres de requête mailingDateFrom et mailingDateTo sont obligatoires et doivent être inclus.\n\nLe service Obtenir un résumé de repérage fournit seulement les résultats du repérage pour les colis qui ont été expédiés à l'intérieur de la plage de dates précisées par les paramètres de requête mailingDateFrom et mailingDateTo."
                    required: true
                    schema:
                        type: string
                        format: date
                    example: '2024-01-30'
                -
                    $ref: '#/components/parameters/language'
            responses:
                200:
                    $ref: '#/components/responses/200-trackSummary'
                400:
                    $ref: '#/components/responses/400-track'
                401:
                    $ref: '#/components/responses/401'
                403:
                    $ref: '#/components/responses/403'
                404:
                    $ref: '#/components/responses/404'
                500:
                    $ref: '#/components/responses/500'
                503:
                    $ref: '#/components/responses/503'
                504:
                    $ref: '#/components/responses/504'
            operationId: TrackingSummaryReference
    '/pins/{pinNumber}/details':
        get:
            tags:
                - Tracking
            summary: 'Tracking Details (PIN)'
            description: 'Returns all tracking events for a package. The package is identified using a PIN.'
            x-ibm-languages:
                description:
                    fr: "Retourne tous les événements de suivi pour un package. Le colis est identifié à l'aide d'un code PIN."
                summary:
                    fr: 'Détails du suivi (NIP)'
            parameters:
                -
                    $ref: '#/components/parameters/pinNumber'
                -
                    $ref: '#/components/parameters/platformID'
                -
                    $ref: '#/components/parameters/language'
            responses:
                200:
                    $ref: '#/components/responses/200-trackDetail'
                400:
                    $ref: '#/components/responses/400-track'
                401:
                    $ref: '#/components/responses/401'
                403:
                    $ref: '#/components/responses/403'
                404:
                    $ref: '#/components/responses/404'
                500:
                    $ref: '#/components/responses/500'
                503:
                    $ref: '#/components/responses/503'
                504:
                    $ref: '#/components/responses/504'
            operationId: trackingDetailsByPin
    '/dncs/{dncNumber}/details':
        get:
            tags:
                - Tracking
            summary: 'Tracking Details (DNC)'
            description: 'This call returns all tracking events recorded for a specified parcel. The parcel is identified using a DNC Number.'
            x-ibm-languages:
                description:
                    fr: "Cet appel retourne tous les événements de suivi enregistrés pour un colis spécifié. Le colis est identifié à l'aide d'un numéro DNC."
                summary:
                    fr: 'Détails du suivi (Dnc)'
            parameters:
                -
                    $ref: '#/components/parameters/dncNumber'
                -
                    $ref: '#/components/parameters/platformID'
                -
                    $ref: '#/components/parameters/language'
            responses:
                200:
                    $ref: '#/components/responses/200-trackDetail'
                400:
                    $ref: '#/components/responses/400-track'
                401:
                    $ref: '#/components/responses/401'
                403:
                    $ref: '#/components/responses/403'
                404:
                    $ref: '#/components/responses/404'
                500:
                    $ref: '#/components/responses/500'
                503:
                    $ref: '#/components/responses/503'
                504:
                    $ref: '#/components/responses/504'
            operationId: trackingDetailsByDNC
    /create-certificate:
        post:
            tags:
                - 'create certificate'
            summary: 'Get Delivery Confirmation Certificate'
            description: 'If the package has been delivered, this call returns a PDF with the tracking number, service used, reference numbers, delivery date, signatory name, and signature image (if available).'
            x-ibm-languages:
                summary:
                    fr: 'Obtenir le Certificat de confirmation de livraison'
                description:
                    fr: 'Si le colis a été livré, cette fonction affiche un fichier PDF avec le numéro de repérage, le service utilisé, les numéros de référence, la date de livraison, le nom du signataire et l’image de la signature, le cas échéant.'
            parameters:
                -
                    $ref: '#/components/parameters/language'
            requestBody:
                content:
                    application/json:
                        schema:
                            $ref: '#/components/schemas/createCertificateRequest'
                        example:
                            pin: 8720042296149349
                            language: en
            responses:
                200:
                    description: 'The 200 (OK) status code indicates that the request has succeeded. The response payload is returned.'
                    x-ibm-languages:
                        description:
                            fr: 'Le code d’état 200 (OK) indique que la demande a été traitée avec succès. La charge utile de réponse est retournée.'
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/createCertificateResponse'
                            example:
                                image: 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Qm94WzAgMCA2MDAgODAwXS9MZW5ndGggMjQ+PnN0cmVhbQp4nLMwUDAyMlDI5TI1gbByuIK5ACvfA/QKZW5kc3RyZWFtCmVuZG9iago4IDAgb2JqCjw8L0tpZHNbOSAwIFJdL1R5cGUvUGFnZXMvQ291bnQgMT4+CmVuZG9iagoxMCAwIG9iago8PC9UeXBlL0NhdGFsb2cvUGFnZXMgOCAwIFIvVmlld2VyUHJlZmVyZW5jZXM8PC9GaXRXaW5kb3cgdHJ1ZT4+Pj4KZW5kb2JqCjExIDAgb2JqCjw8L0NyZWF0b3IoQ2FuYWRhIFBvc3QgQ29ycG9yYXRpb24pL0NyZWF0aW9uRGF0ZShEOjIwMjUxMjE4MTU1MTU2WikvUHJvZHVjZXIoT3BlblBERiAyLjQuMCkvU3ViamVjdChDYW5hZGEgUG9zdCBDb3Jwb3JhdGlvbiAtIERlbGl2ZXJ5IENvbmZpcm1hdGlvbiBDZXJ0aWZpY2F0ZSkvQXV0aG9yKEV2ZW50IE1hbmFnZXIpL1RpdGxlKENhbmFkYSBQb3N0IENvcnBvcmF0aW9uKT4+CmVuZG9iagp4cmVmCjAgMTIKMDAwMDAwMDAwMCA2NTUzNSBmIAowMDAwMDE1MTk3IDAwMDAwIG4gCjAwMDAwMDAwMTUgMDAwMDAgbiAKMDAwMDAxMTM4OSAwMDAwMCBuIAowMDAwMDE0OTE2IDAwMDAwIG4gCjAwMDAwMTUwMDkgMDAwMDAgbiAKMDAwMDAxNTA5NyAwMDAwMCBuIAowMDAwMDEzMjY0IDAwMDAwIG4gCjAwMDAwMTUzNzcgMDAwMDAgbiAKMDAwMDAxNDc0MiAwMDAwMCBuIAowMDAwMDE1NDI4IDAwMDAwIG4gCjAwMDAwMTU1MTEgMDAwMDAgbiAKdHJhaWxlcgo8PC9JbmZvIDExIDAgUi9JRCBbPGIxN2QzMDZjN2NlZWZkM2MwN2ZkZjdjNjRiNWM1M2IzPjxiMTdkMzA2YzdjZWVmZDNjMDdmZGY3YzY0YjVjNTNiMz5dL1Jvb3QgMTAgMCBSL1NpemUgMTI+PgpzdGFydHhyZWYKMTU3NDMKJSVFT0YK
                400:
                    $ref: '#/components/responses/400'
                401:
                    $ref: '#/components/responses/401'
                403:
                    $ref: '#/components/responses/403'
                404:
                    $ref: '#/components/responses/404'
                500:
                    $ref: '#/components/responses/500'
                503:
                    $ref: '#/components/responses/503'
                504:
                    $ref: '#/components/responses/504'
            operationId: createCertificateDNC
components:
    parameters:
        platformID:
            name: platform-id
            in: header
            description: 'ID associated with the platform.'
            x-ibm-languages:
                description:
                    fr: 'Identifiant associé à la plateforme.'
            required: false
            schema:
                $ref: '#/components/schemas/customerNumber'
        pinNumber:
            name: pinNumber
            in: path
            description: "The PIN (Parcel Identification Number) assigned by Canada Post on creation of the shipping label and used for tracking purposes.\n\n(12, 13 or 16 characters)\n\nWhen executing a request by PIN, this is mandatory and is the only parameter necessary."
            x-ibm-languages:
                description:
                    fr: "Le numéro d'identification du produit (NIP) est attribué par Postes Canada au cours de la création de l'étiquette d'expédition et utilisé aux fins de repérage.\n\n(12, 13 ou 16 caractères)\n\nLorsque vous exécutez une demande avec le NIP, il est obligatoire et il s'agit du seul paramètre nécessaire."
            required: true
            schema:
                type: string
            example: 7023210215628702
        dncNumber:
            name: dncNumber
            in: path
            description: "The Delivery Notice Card (DNC) number – The number on the card left by delivery personnel when no one is home to receive the delivery.\n\n(15 numeric characters)\n\nWhen executing a request by DNC number, this is mandatory and is the only parameter necessary."
            x-ibm-languages:
                description:
                    fr: "Numéro de la carte Avis de livraison (CAL) : Le numéro sur la carte laissé par le personnel de livraison lorsqu'il n'y a personne à la maison pour recevoir la livraison.\n\n(15 caractères numériques)\n\nLorsque vous exécutez une demande avec le numéro de la CAL, il est obligatoire et il s'agit du seul paramètre nécessaire."
            required: true
            schema:
                type: string
            example: 168067817265091
        language:
            name: Accept-Language
            in: header
            description: "Indicates your language preference for receiving error messages.\n\n- en-CA = English\n- fr-CA = French"
            x-ibm-languages:
                description:
                    fr: "Indique votre langue de préférence pour recevoir les messages d'erreur.\n- en-CA = Anglais - fr-CA = Français"
            schema:
                type: string
                enum:
                    - en-CA
                    - fr-CA
                example: en-CA
                default: en-CA
    responses:
        400:
            description: 'The 400 (Bad Request) status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error (for example, malformed request syntax). There will be diagnostic message text in the preferred language (English or French).'
            x-ibm-languages:
                description:
                    fr: 'Le code d’état 400 (Mauvaise demande) indique que le serveur ne peut pas ou ne veut pas traiter la demande en raison d’une erreur de la clientèle (p. ex., syntaxe de demande mal formée). Il y aura un message de diagnostic dans la langue de préférence (français ou anglais).'
            content:
                application/json:
                    schema:
                        $ref: '#/components/schemas/messages'
        401:
            description: 'The 401 (Unauthorized) status code indicates that the server understood the request but refuses to fulfill it.'
            x-ibm-languages:
                description:
                    fr: "Le code d'état 401 (Non autorisé) indique que le serveur a compris la requête mais refuse de la satisfaire."
            content:
                application/json:
                    schema:
                        $ref: '#/components/schemas/unauthorizedError'
                    example:
                        -
                            httpCode: 401
                            httpMessage: Unauthorized
                            moreInformation: 'Cannot pass the security checks that are required by the target API or operation, Enable debug headers for more details.'
        403:
            description: "The HTTP 403 (Forbidden) error means the web server received your request but denies you access to the requested resource because you don't have permission."
            x-ibm-languages:
                description:
                    fr: "L'erreur HTTP 403 (Interdit) signifie que le serveur Web a reçu votre requête mais vous refuse l'accès à la ressource demandée car vous n'en avez pas l'autorisation."
        404:
            description: 'The 404 (Not Found) status code indicates that the origin server did not find a current representation for the target resource or is not willing to disclose that one exists.'
            x-ibm-languages:
                description:
                    fr: "Le code d'état 404 (Introuvable) indique que le serveur d'origine n'a pas trouvé de représentation actuelle pour la ressource cible ou ne souhaite pas divulguer son existence."
            content:
                application/json:
                    schema:
                        $ref: '#/components/schemas/messages'
        500:
            description: 'The 500 (Internal Server Error) status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the request. Passed through from backend.'
            x-ibm-languages:
                description:
                    fr: "Le code d'état 500 (Erreur interne du serveur) indique que le serveur a rencontré une condition inattendue l'empêchant de traiter la requête. Transmis par le serveur d'arrière-plan."
        503:
            description: 'The 503 (Service Unavailable) status code indicates that the server is currently unable to handle the request due to a temporary overload or scheduled maintenance, which will likely be alleviated after some delay. Passed through from backend.'
            x-ibm-languages:
                description:
                    fr: "Le code d'état 503 (Service indisponible) indique que le serveur est actuellement indisponible en raison d'une surcharge temporaire ou d'une maintenance planifiée, qui devrait être résolue après un certain délai. Message transmis par le serveur d'arrière-plan."
        504:
            description: 'The 504 (Gateway Timeout) status code indicates that the server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request. May be passed through from backend.'
            x-ibm-languages:
                description:
                    fr: "Le code d'état 504 (Délai d'attente de la passerelle) indique que le serveur, agissant comme passerelle ou proxy, n'a pas reçu de réponse dans un délai raisonnable d'un serveur en amont auquel il devait accéder pour traiter la requête. Ce code peut provenir du serveur principal."
        200-trackSummary:
            description: 'The 200 (OK) status code indicates that the request has succeeded. The response payload is returned.'
            x-ibm-languages:
                description:
                    fr: 'Le code d’état 200 (OK) indique que la demande a été traitée avec succès. La charge utile de réponse est retournée.'
            content:
                application/json:
                    schema:
                        $ref: '#/components/schemas/trackingSummary'
                    examples:
                        English:
                            value:
                                -
                                    pin: 7023210039414604
                                    originPostalId: K1G
                                    destinationPostalId: K0J
                                    destinationProvince: 'ON'
                                    serviceName: 'Expedited Parcels'
                                    mailedOnDate: '2023-04-04T00:00:00.000Z'
                                    expectedDeliveryDate: '2023-04-05T00:00:00.000Z'
                                    actualDeliveryDate: '2023-04-05T00:00:00.000Z'
                                    deliveryOptionCompletedInd: 2
                                    eventDateTime: '20230404:133457'
                                    eventDescription: 'Electronic information submitted by shipper'
                                    attemptedDate: '2023-04-05T00:00:00.000Z'
                                    customerRef1: APRIL1REF1A
                                    customerRef2: APRIL1REF1C
                                    returnPin: null
                                    eventType: INDUCTION
                                    eventLocation: 'OROMOCTO,NB'
                        Français:
                            value:
                                -
                                    pin: 7023210039414604
                                    originPostalId: K1G
                                    destinationPostalId: K0J
                                    destinationProvince: 'ON'
                                    serviceName: 'Colis accélérés'
                                    mailedOnDate: '2023-04-04T00:00:00.000Z'
                                    expectedDeliveryDate: '2023-04-05T00:00:00.000Z'
                                    actualDeliveryDate: '2023-04-05T00:00:00.000Z'
                                    deliveryOptionCompletedInd: 2
                                    eventDateTime: '20230404:133457'
                                    eventDescription: "Les renseignements électroniques ont été soumis par l'expéditeur"
                                    attemptedDate: '2023-04-05T00:00:00.000Z'
                                    customerRef1: APRIL1REF1A
                                    customerRef2: APRIL1REF1C
                                    returnPin: null
                                    eventType: INDUCTION
                                    eventLocation: 'OROMOCTO,NB'
        200-trackDetail:
            description: 'The 200 (OK) status code indicates that the request has succeeded. The response payload is returned.'
            x-ibm-languages:
                description:
                    fr: 'Le code d’état 200 (OK) indique que la demande a été traitée avec succès. La charge utile de réponse est retournée.'
            content:
                application/json:
                    schema:
                        $ref: '#/components/schemas/trackingDetail'
                    examples:
                        English:
                            value:
                                pin: 3167437095800812
                                activeExists: true
                                archiveExists: false
                                changedExpectedDate: '2023-12-11T00:00:00.000Z'
                                destinationPostalId: E2V1C0
                                expectedDeliveryDate: '2023-12-08T00:00:00.000Z'
                                changedExpectedDeliveryReason: Friday
                                originalPin: 7022137378507402
                                serviceName: 'Expedited Parcels'
                                serviceName2: 'Colis accélérés'
                                customerRef1: 8618725947
                                customerRef2: 111
                                returnPin: ''
                                signatureImageExists: true
                                suppressSignature: false
                                deliveryOptions:
                                    -
                                        deliveryOption: CH_SGN_OPTION
                                        deliveryOptionDescription: 'Signature Required'
                                significantEvents:
                                    -
                                        eventIdentifier: 1496
                                        eventDate: '2023-12-11T00:00:00.000Z'
                                        eventTime: '11:59:59'
                                        eventTimeZone: AST
                                        eventDescription: Delivered
                                        eventSite: OROMOCTO
                                        eventProvince: NB
                                        eventRetailLocationId: null
                                        eventRetailName: null
                                    -
                                        eventIdentifier: 20
                                        eventDate: '2023-12-11T00:00:00.000Z'
                                        eventTime: '09:50:23'
                                        eventTimeZone: AST
                                        eventDescription: 'Signature available'
                                        eventSite: OROMOCTO
                                        eventProvince: null
                                        eventRetailLocationId: null
                                        eventRetailName: null
                        Français:
                            value:
                                pin: 3167437095800812
                                activeExists: true
                                archiveExists: false
                                changedExpectedDate: '2023-12-11T00:00:00.000Z'
                                destinationPostalId: E2V1C0
                                expectedDeliveryDate: '2023-12-08T00:00:00.000Z'
                                changedExpectedDeliveryReason: Friday
                                originalPin: 7022137378507402
                                serviceName: 'Expedited Parcels'
                                serviceName2: 'Colis accélérés'
                                customerRef1: 8618725947
                                customerRef2: 111
                                returnPin: ''
                                signatureImageExists: true
                                suppressSignature: false
                                deliveryOptions:
                                    -
                                        deliveryOption: CH_SGN_OPTION
                                        deliveryOptionDescription: 'Signature requise'
                                significantEvents:
                                    -
                                        eventIdentifier: 1496
                                        eventDate: '2023-12-11T00:00:00.000Z'
                                        eventTime: '11:59:59'
                                        eventTimeZone: AST
                                        eventDescription: Livré
                                        eventSite: OROMOCTO
                                        eventProvince: NB
                                        eventRetailLocationId: null
                                        eventRetailName: null
                                    -
                                        eventIdentifier: 20
                                        eventDate: '2023-12-11T00:00:00.000Z'
                                        eventTime: '09:50:23'
                                        eventTimeZone: AST
                                        eventDescription: 'Signature disponible'
                                        eventSite: OROMOCTO
                                        eventProvince: null
                                        eventRetailLocationId: null
                                        eventRetailName: null
        400-track:
            description: 'The 400 (Bad Request) status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error (for example, malformed request syntax). There will be diagnostic message text in the preferred language (English or French).'
            x-ibm-languages:
                description:
                    fr: 'Le code d’état 400 (Mauvaise demande) indique que le serveur ne peut pas ou ne veut pas traiter la demande en raison d’une erreur de la clientèle (p. ex., syntaxe de demande mal formée). Il y aura un message de diagnostic dans la langue de préférence (français ou anglais).'
            content:
                application/json:
                    schema:
                        $ref: '#/components/schemas/messages'
                    examples:
                        English:
                            value:
                                title: 'Validation failed'
                                detail: 'Errors occurred while processing the request.'
                                errors:
                                    -
                                        errorCode: '002'
                                        message: 'Duplicate Pin'
                                    -
                                        errorCode: '008'
                                        message: 'Invalid Date'
                        Français:
                            value:
                                title: 'Validation échouée'
                                detail: 'Une erreur est survenue lors du traitement de la demande.'
                                errors:
                                    -
                                        errorCode: '002'
                                        message: 'NIP en double'
                                    -
                                        errorCode: '008'
                                        message: 'Date invalide'
    schemas:
        customerNumber:
            type: string
            minLength: 1
            maxLength: 10
            example: '0007271592'
        createCertificateRequest:
            type: object
            properties:
                pin:
                    type: integer
                    description: 'A numeric PIN, typically used for authentication or identification'
                language:
                    type: string
                    description: 'The preferred language for the request (e.g., "en" for English)'
                    enum:
                        - en
                        - fr
            required:
                - pin
                - language
        createCertificateResponse:
            type: object
            properties:
                image:
                    type: string
        pinNumber:
            description: "The PIN (Parcel Identification Number) assigned by Canada Post on creation of the shipping label and used for tracking purposes.\n\n(12, 13 or 16 characters)\n\nWhen executing a request by PIN, this is mandatory and is the only parameter necessary."
            x-ibm-languages:
                description:
                    fr: "Le numéro d'identification du produit (NIP) est attribué par Postes Canada au cours de la création de l'étiquette d'expédition et utilisé aux fins de repérage.\n\n(12, 13 ou 16 caractères)\n\nLorsque vous exécutez une demande avec le NIP, il est obligatoire et il s'agit du seul paramètre nécessaire."
            type: string
            example: 7023210215628702
        dncNumber:
            description: "The Delivery Notice Card (DNC) number – The number on the card left by delivery personnel when no one is home to receive the delivery.\n\n(15 numeric characters)\n\nWhen executing a request by DNC number, this is mandatory and is the only parameter necessary."
            type: string
            pattern: '^\d{15}$'
            example: 168067817265091
        pin:
            description: "The Parcel Identification Number (PIN) that can be used by the client for calling tracking services.\n\n---\n\nNuméro d'identification du colis (NIP) pouvant être utilisé par le client pour faire appel aux services de repérage."
            type: string
        destinationPostalId:
            description: "The first 3 characters of the destination Postal Code for parcels to be delivered in Canada.\n\nFor international parcels this is the postal identifier of the destination country (e.g. ZIP code for parcels with a U.S. destination) or an identifier of the destination country.\n\n---  \n\nTrois premiers caractères du code postal de destination pour les colis qui doivent être livrés au Canada.\n\nPour les colis du régime international, il s'agit de l'identificateur postal du pays de destination (p. ex., le code ZIP pour les colis à destination des É.-U.) ou un identificateur du pays de destination."
            type: string
        expectedDeliveryDate:
            description: "The date the item is expected to reach the destination address for addresses in Canada.\n\nIf the item has been mailed from or to an international location this date may be blank.\n\n---\n\nDate à laquelle l'article doit arriver à l'adresse de destination pour les adresses au Canada.\n\nSi l'article a été expédié à destination ou en provenance de l'étranger, cette date peut ne pas être indiquée."
            type: string
            format: date
        serviceName:
            description: "Canada Post service name in the language specified. The service name will default to English if language is not specified.\n\nFor inbound international parcels, service name is empty or contains the service name from its shipper of origin if available.\n\n---\n\nNom du service de Postes Canada dans la langue précisée. Le nom de service sera indiqué par défaut en anglais si la langue n'est pas précisée.\n\nPour les colis d'arrivée du régime international, le champ relatif au nom du service est vide ou il contient le nom du service fourni par l'expéditeur d'origine, le cas échéant."
            type: string
        customerRef1:
            description: "The value supplied by the shipper as customer-ref-1 when the shipment was first created with Canada Post. French character set is supported through this interface.\n\n---\n\nValeur fournie par l'expéditeur (customer-ref-1) lorsque l'envoi a d'abord été créé auprès de Postes Canada. L'ensemble de caractères en français est appuyé par cette interface."
            type: string
        customerRef2:
            description: "The value supplied by the shipper as customer-ref-2 when the shipment was first created with Canada Post. French character set is supported through this interface.\n\n---\n\nValeur fournie par l'expéditeur (customer-ref-2) lorsque l'envoi a d'abord été créé auprès de Postes Canada. L'ensemble de caractères en français est appuyé par cette interface."
            type: string
        returnPin:
            description: "If a return label (PIN) was printed at the same time the shipment was created and the shipment is being returned, the return PIN is displayed.\n\n---\n\nSi une étiquette Service de retour (NIP) a été imprimée en même temps que l'envoi a été créé et que l'envoi est retourné, le NIP de retour est affiché."
            type: string
        trackingSummary:
            description: "Get Tracking Summary - Response\n\n---\n\nObtenir un résumé du repérage - Réponse"
            type: array
            items:
                type: object
                properties:
                    pin:
                        $ref: '#/components/schemas/pin'
                    originPostalId:
                        description: "The first 3 characters of the origin Postal Code for Canadian destinations.\n\nFor an inbound international parcel, this field is blank or contains the postal identifier of the country of origin.  \n\n---\n\nTrois premiers caractères du code postal d'origine pour les destinations canadiennes.\n\nDans le cas d'un colis d'arrivée du régime international, ce champ est vide ou il contient l'identificateur postal du pays d'origine."
                        type: string
                    destinationPostalId:
                        $ref: '#/components/schemas/destinationPostalId'
                    destinationProvince:
                        description: "The 2-character province code for the destination.\n\n\"postal designators\" - abbreviations used by Canada Post  ISO 3166-2  for Canadian bound parcels.\n\nParcels bound for international destinations have the postal identifier of the destination country (e.g. ZIP code for parcels with a U.S. destination).\n\n---\n\nCode de province à deux caractères pour la destination.\n\n« indicateurs postaux » – abréviations utilisées par Postes Canada (ISO 3166-2) pour les colis du régime intérieur.\n\nLes colis à destination des É.-U. et du régime international portent l'identificateur postal du pays de destination (p. ex., le code ZIP pour les colis à destination des É.-U.)."
                        type: string
                        minLength: 2
                        maxLength: 2
                    serviceName:
                        $ref: '#/components/schemas/serviceName'
                    mailedOnDate:
                        description: "The date of the first event for the item. If the item has been mailed from an international location this date may be blank.\n\n---\n\nDate de la première activité pour l'article. Si l'article a été expédié à partir d'une destination internationale, cette date peut ne pas être indiquée."
                        type: string
                        format: date
                    expectedDeliveryDate:
                        $ref: '#/components/schemas/expectedDeliveryDate'
                    actualDeliveryDate:
                        description: "The date the item was delivered.\n\nBlank if not delivered or if delivery information from an international organization for an international shipment has not been provided.\n\n---\n\nDate à laquelle l'article a été livré.\n\nN'apparaît pas si l'article n'a pas été livré ou si les données de livraison provenant d'un organisme international n'ont pas été fournies pour un envoi du régime international."
                        type: string
                        format: date
                    deliveryOptionCompletedInd:
                        description: "- 0 – at least one option was not satisfied\n- 1 – all options were satisfied\n- 2 – no options were found\n\n---\n\n- 0 – Au moins une option n'a pas été satisfaite\n- 1 – toutes les options ont été satisfaites\n- 2 – aucune option n'a été trouvée"
                        enum:
                            - '0'
                            - '1'
                            - '2'
                    eventDateTime:
                        description: "yyyymmdd:hhmmss\n\nThe time stamp of the most recent significant event.\n\n---\n\naaaammjj :hhmmss\n\nHorodatage de l'activité la plus récente ou la plus importante."
                        type: string
                        pattern: '^\d{8}:\d{6}$'
                    eventDescription:
                        description: "A brief description of the event.\n\n---\n\nBrève description de l'activité."
                        type: string
                    attemptedDate:
                        description: "The date that a delivery was attempted.\n\nFor shipments into or within Canada this will indicate that an unsuccessful attempt to deliver the parcel was made on the specified date.\n\n---\n\nDate à laquelle une tentative de livraison à été effectuée.\n\nPour les articles envoyés au Canada ou les articles du régime intérieur, il sera indiqué qu'une tentative infructueuse de livraison a été effectuée à la date précisée."
                        type: string
                        format: date
                    customerRef1:
                        $ref: '#/components/schemas/customerRef1'
                    customerRef2:
                        $ref: '#/components/schemas/customerRef2'
                    returnPin:
                        $ref: '#/components/schemas/returnPin'
                    eventType:
                        description: "The value in this field will indicate what type of event is represented for this item.\n\n---\n\n\nValeur dans ce champ qui montre quel type d'activité est indiqué pour cet article."
                        type: string
                    eventLocation:
                        description: "For an event representing a scan or delivery, this value will indicate the location where the event took place.\n\n---\n\nPour une activité correspondant à un balayage ou à une livraison, cette valeur indiquera l'emplacement où l'activité a eu lieu."
                        type: string
                    error:
                        description: ''
                        type: object
                        properties:
                            code:
                                description: ''
                                type: string
                            descEn:
                                description: ''
                                type: string
                            descFr:
                                description: ''
                                type: string
                        additionalProperties: false
                        required:
                            - code
                            - descEn
                            - descFr
                additionalProperties: false
                required:
                    - pin
        trackingDetail:
            description: "Get Tracking Details - Response\n\n---\n\nObtenir les détails du suivi - Réponse"
            type: object
            properties:
                pin:
                    $ref: '#/components/schemas/pin'
                activeExists:
                    description: "\"true\" Indicates that the tracking information is contained in the active data repository.\n\n---\n\nLa mention \"true\" signifie que les données de repérage figurent dans la base de données actives."
                    type: boolean
                archiveExists:
                    description: "\"true\" Indicates that the tracking information is contained in the archive data repository.\n\n---\n\nLa mention \"true\" signifie que les données de repérage figurent dans la base de données archivées."
                    type: boolean
                changedExpectedDate:
                    description: "Indicates a new expected delivery date.\n\n---\n\nIl s'agit de la nouvelle date de livraison prévue."
                    type: string
                    format: date
                destinationPostalId:
                    $ref: '#/components/schemas/destinationPostalId'
                expectedDeliveryDate:
                    $ref: '#/components/schemas/expectedDeliveryDate'
                changedExpectedDeliveryReason:
                    description: "Text description of reason for change to expected delivery date.\n\n---\n\nDescription du texte pour la raison du changement de la date de livraison prévue."
                    type: string
                originalPin:
                    description: "In the situation where a parcel is being returned and the original parcel was created with an anticipated return, this field will contain the original PIN when the return PIN is queried.\n\n---\n\nSi un colis est retourné et que le colis initial a été créé avec une étiquette Service de retour prévu, ce champ contiendra le NIP initial lorsque le NIP de retour est demandé."
                    type: string
                serviceName:
                    $ref: '#/components/schemas/serviceName'
                serviceName2:
                    description: "Canada Post service name in the other Canadian official language. For inbound international parcels, service name is empty or contains the service name from its shipper of origin.  \n\n---\n\nNom du service de Postes Canada dans l'autre langue officielle du Canada. Pour les colis d'arrivée du régime international, le champ relatif au nom du service est vide ou il contient le nom du service fourni par l'expéditeur d'origine."
                    type: string
                customerRef1:
                    $ref: '#/components/schemas/customerRef1'
                customerRef2:
                    $ref: '#/components/schemas/customerRef2'
                returnPin:
                    $ref: '#/components/schemas/returnPin'
                signatureImageExists:
                    description: "True indicates that Get Signature Image will return a signature image. If false, there is no need to call Get Signature Image because it will return \"not found\".  \n\n---\n\nVrai : L'option « Obtenir l'image de la signature » affichera l'image de la signature. Faux : Il n'est pas nécessaire de sélectionner l'option « Obtenir l'image de la signature » puisque le système indiquera qu'aucune image n'est trouvée."
                    type: boolean
                suppressSignature:
                    description: "Indicates whether a signature image collected by Canada Post for domestic parcels has been requested to be suppressed for viewing by the recipient of a parcel.  \n\n---\n\nIndique si le destinataire du colis a demandé de supprimer l'image de sa signature recueillie par Postes Canada pour les colis du régime intérieur afin qu'elle ne puisse pas être visualisée par d'autres."
                    type: boolean
                deliveryOptions:
                    description: "The set of delivery options requested for this parcel.\n\n---\n\nSérie d'options de livraison demandées pour ce colis."
                    type: array
                    items:
                        type: object
                        properties:
                            deliveryOption:
                                description: "The code representing the delivery option.\n\n---\n\nLa chaîne représente l'option de livraison."
                                type: string
                            deliveryOptionDescription:
                                description: "The description of the delivery option.\n\n---\n\nDescription de l'option de livraison."
                                type: string
                        additionalProperties: false
                        required:
                            - deliveryOption
                            - deliveryOptionDescription
                codRemitInfo:
                    description: "Information associating a COD parcel with the remittance tracking event or vice versa.\n\n---\n\nRenseignements associant un colis CR à une activité de repérage du paiement ou vice versa."
                    type: object
                    properties:
                        pin:
                            description: "This instance of the PIN specifies the PIN of the COD remittance or the original parcel depending on the value of type.\n\n---\n\nDans ce cas, il s'agit du NIP d'un paiement CR ou du colis initial selon la valeur du type."
                            type: string
                        type:
                            description: "Has the value COD_PIN or REMIT_PIN and indicates what PIN is contained in the PIN value immediately above.\n\n---\n\nValeur de « COD_PIN » ou de « REMIT_PIN ». Il indique le NIP correspondant à la valeur susmentionnée."
                            enum:
                                - COD_PIN
                                - REMIT_PIN
                    additionalProperties: false
                    required:
                        - pin
                        - type
                significantEvents:
                    description: "The list of events associated with this parcel.\n\n---\n\nDétails du suivi (Dnc)La liste des événements associés à ce colis."
                    type: array
                    items:
                        type: object
                        properties:
                            eventIdentifier:
                                description: "Event identifier used to identify event types.\n\n---\n\nListe d'activités associées au colis."
                                type: string
                            eventDate:
                                description: "Date of a tracking event.\n\n---\n\nDate de l'activité de repérage."
                                type: string
                                format: date
                            eventTime:
                                description: "Time of a tracking event (hh:mm:ss).\n\n---\n\nHeure de l'activité de repérage (hh:mm:ss)."
                                type: string
                            eventTimeZone:
                                description: "Time zone associated with an event. May not be populated for international tracking events.\n\n---\n\nFuseau horaire associé à l'activité. Il pourrait ne pas être défini pour les activités de repérage à l'échelle internationale."
                                type: string
                            eventDescription:
                                description: "A brief description of the event.\n\n---\n\nBrève description de l'activité."
                                type: string
                            eventSite:
                                description: "Site information provided by the parcel handler.\n\n---\n\nRenseignements sur l'emplacement fournis par le préposé au service de colis."
                                type: string
                            eventProvince:
                                description: "For domestic events, this contains the province that the event occurred in.\n\n---\n\nPour les activités du régime intérieur, il contient la province où l'activité a eu lieu."
                                type: string
                            eventRetailLocationId:
                                description: "Contains the office id where a parcel is being/was retained.\n\n---\n\nContient l'office-id lorsqu'un colis est retenu ou qu'il a été retenu."
                                type: string
                            eventRetailName:
                                description: "Retail name of the location where a parcel is/was held.\n\n---\n\nNom du comptoir postal où le colis est retenu."
                                type: string
                        additionalProperties: false
                        required:
                            - eventDate
                            - eventTime
            additionalProperties: false
            required:
                - pin
                - activeExists
                - archiveExists
                - signatureImageExists
                - suppressSignature
        messages:
            type: object
            properties:
                title:
                    type: string
                    description: "Type of error.\n\n---\n\nType d'erreur."
                detail:
                    type: string
                    description: "Detailed description of type of error.\n\n---\n\nDescription détaillée du type d'erreur."
                errors:
                    type: array
                    description: "List of errors.\n\n---\n\nListe des erreurs."
                    items:
                        type: object
                        properties:
                            errorCode:
                                type: string
                                description: "Error code related to error.\n\n---\n\nCode d'erreur lié à l'erreur."
                            message:
                                type: string
                                description: "Detailed message for the error that occured.\n\n---\n\nMessage détaillé concernant l'erreur survenue."
                        required:
                            - message
                            - errorCode
                        additionalProperties: false
            required:
                - title
                - detail
                - errors
            additionalProperties: false
            example:
                title: 'Validation failed'
                detail: 'Errors occurred while processing the request.'
                errors:
                    -
                        errorCode: '002'
                        message: 'Duplicate Pin'
        unauthorizedError:
            type: object
            properties:
                httpCode:
                    type: string
                    description: "Code associated with the unauthorized error.\n  ---\n\nCode associé à l'erreur d'autorisation."
                httpMessage:
                    type: string
                    description: "Error message.\n  ---\n\nmessage d'erreur."
                moreInformation:
                    type: string
                    description: "Detailed error message.\n  ---\n\nMessage d'erreur détaillé."
    securitySchemes:
        Oauth2:
            type: oauth2
            x-ibm-oauth-provider: cpc-api-native-oauth-provider
            flows:
                clientCredentials:
                    tokenUrl: 'https://api.canadapost-postescanada.ca/prod/devportal-portaildesdeveloppeurs/cpc-api-native-oauth-provider/oauth2/token'
                    scopes:
                        merchant: 'default description'
                        platform: ''
x-ibm-configuration:
    cors:
        enabled: true
    type: rest
    phase: realized
    enforced: true
    testable: true
    oauth-servers:
        Oauth2:
            clientCredentials:
                tokenUrls:
                    - 'https://api.canadapost-postescanada.ca/prod/devportal-portaildesdeveloppeurs/cpc-api-native-oauth-provider/oauth2/token'
                authorizationUrls: {  }
                refreshUrls: {  }
x-ibm-endpoints:
    -
        url: 'https://api.canadapost-postescanada.ca/prod/devportal-portaildesdeveloppeurs/tracking/v1'
security:
    -
        Oauth2:
            - merchant
