{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Verify and Troubleshoot","description":"Developer documentation for integrating systems that send messages, plus reporting and operational APIs for platform holders."},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"verify-and-troubleshoot","__idx":0},"children":["Verify and Troubleshoot"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After submitting a delivery request, integrations must verify that the delivery has been processed successfully and handle any errors that may occur."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Delivery processing is asynchronous."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Do not assume immediate completion after submitting a delivery."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"when-to-check-delivery-status","__idx":1},"children":["When to Check Delivery Status"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Delivery status should be checked when:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The delivery request has been accepted and a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deliveryId"]}," has been returned"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["At least 15 minutes have elapsed since submission"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A previous status indicated ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Processing"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A retry attempt has been completed"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The first status check should occur no earlier than 15 minutes after submission."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Processing time depends on:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Number of envelopes"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Size of attachments"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Virus scanning duration"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Recipient resolution complexity"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Platform load"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"delivery-and-envelope-status-report","__idx":2},"children":["Delivery and Envelope Status (Report)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Delivery status is retrieved using ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /delivery/v1/deliveries/{deliveryId}"]}," (",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/delivery/delivery/other/getdeliveryreport"},"children":["Get delivery report"]},")."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The delivery report is the authoritative source for delivery progress and outcomes."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"delivery-level-fields","__idx":3},"children":["Delivery-Level Fields"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The report includes:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status"]}," — ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Processing"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Completed"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["totalEnvelopes"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deliveredEnvelopes"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["While ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Processing"]},", envelopes are actively being processed."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status"]}," becomes ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Completed"]},", processing has finished and counts are final."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Important:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Completed"]}," does not mean all envelopes succeeded.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"It means processing is finished."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"envelope-level-results","__idx":4},"children":["Envelope-Level Results"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Envelope outcomes are reported in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["logs"]}," array."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each log entry contains:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["envelopeId"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["level"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["key"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["description"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Optional ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["delivered"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Important behavior:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Successfully delivered envelopes are not listed in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["logs"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["There may be multiple entries for the same ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["envelopeId"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["delivered"]}," is omitted, the platform is still processing that envelope"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["delivered"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["false"]},", the envelope failed"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"platform-retry-behavior","__idx":5},"children":["Platform Retry Behavior"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If delivery fails due to temporary conditions, the platform automatically retries processing."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Retries may continue for up to one hour."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["During this period:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status"]}," remains ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Processing"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["logs"]}," entries may change"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deliveredEnvelopes"]}," may increase"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After the retry window expires:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status"]}," transitions to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Completed"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Failed envelopes remain in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["logs"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Do not resubmit while the delivery is still ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Processing"]},"."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"delivery-report-failures--logskey-","__idx":6},"children":["Delivery Report Failures (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["logs[].key"]},")"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To support integration logic, failures are categorized by ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["logs[].key"]},"."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Category"},"children":["Category"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Common keys"},"children":["Common keys"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Typical handling"},"children":["Typical handling"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Envelope validation"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["InvalidEnvelope"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fix envelope data/schema and resubmit."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Content missing or invalid"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EnvelopeContentMissing"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EnvelopeContentMediaTypeNotAuthorized"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EnvelopeContentFileExtensionsNotAuthorized"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fix S3 objects and resubmit."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Recipient resolution"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RecipientNotFound"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RecipientNotSubscribed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fix recipient data or subscriptions and resubmit."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sender authorization"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SenderNotFound"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SenderNotAuthorized"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Verify sender configuration and permissions."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Delivery conflicts"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EnvelopeAlreadyDelivered"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EnvelopeAlreadyDeliveredWithOtherDelivery"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EnvelopeBeingProcessedInOtherDelivery"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Verify idempotency and messageId usage."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Security scanning"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["VirusDetected"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Replace content and resubmit."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["S3 access and transfer"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["S3AccessDenied"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["UnabletoConnectAmazonS3"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["S3CopyFailed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Verify S3 credentials and access."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Signing and registration"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["UnableToRegisterSigningRequest"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Retry later or contact support."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Platform or processing"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DeliveryFault"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Retry later; contact support if persistent."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Delivery discovery"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NoEnvelopesFound"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Verify S3 prefixes and envelope presence."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you receive an unknown ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["logs[].key"]},", log it and treat it as a failure requiring investigation."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Correct the underlying issue before resubmitting affected envelopes."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"authorization-errors","__idx":7},"children":["Authorization Errors"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These errors occur when the delivery POST request fails due to authentication or permission issues."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["They are not reported in the delivery report ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["logs"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Examples:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Expired or invalid access token"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Invalid certificate"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Missing permissions for the sender"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Authentication must be revalidated before retrying."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"platform-errors","__idx":8},"children":["Platform Errors"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These errors occur when the delivery POST request fails due to temporary platform conditions."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["They are not reported in the delivery report ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["logs"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Examples:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Service unavailable"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Timeout"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Internal processing error"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These errors may be retried."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"error-response-format","__idx":9},"children":["Error Response Format"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If the delivery POST request fails, the API returns a standard problem details response."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The platform uses:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ProblemDetails"]}," for general errors (401, 403, etc.)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ValidationProblemDetails"]}," for validation errors (400)"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example validation error:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"type\": \"https://tools.ietf.org/html/rfc9110#section-15.5.1\",\n  \"title\": \"One or more validation errors occurred.\",\n  \"status\": 400,\n  \"instance\": \"urn:trace:00-6985dee400000000d374b85cf06dc145-b92e494cc91c9129-01\",\n  \"errors\": {\n    \"$\": [\n      \"JSON deserialization was missing required properties including s3BucketName\"\n    ]\n  },\n  \"traceId\": \"00-6985dee400000000d374b85cf06dc145-b92e494cc91c9129-01\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Always log:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["HTTP status code"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["title"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["instance"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["errors"]}," if present"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["traceId"]}," if present"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Correlation identifiers"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"retry-strategy","__idx":10},"children":["Retry Strategy"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Retries must be implemented carefully."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Safe to retry:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Platform errors"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Temporary network failures"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Temporary authentication failures"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Do not retry automatically:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Envelope validation errors"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Recipient errors"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Content errors"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These require correction before resubmission."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Recommended retry pattern:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["First retry after 30 seconds"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Second retry after 2 minutes"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Third retry after 10 minutes"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Stop after defined maximum attempts"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Avoid aggressive retry loops."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"monitoring-and-logging","__idx":11},"children":["Monitoring and Logging"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Integrations should log:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deliveryId"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Submission timestamp"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Status check timestamp"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Delivery report: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deliveredEnvelopes"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["totalEnvelopes"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["For each ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["logs"]}," entry: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["envelopeId"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["key"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["level"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["delivered"]}," if present"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Error responses for failed POST requests: HTTP status, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["title"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["instance"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["traceId"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These logs support operational troubleshooting and reconciliation."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"best-practices","__idx":12},"children":["Best Practices"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Always verify delivery results"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Wait at least 15 minutes before first status check"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Do not resubmit while status is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Processing"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Inspect envelope-level results"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Separate data errors from technical errors"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Log all failures"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Monitor trends"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"next-steps","__idx":13},"children":["Next Steps"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After verification and troubleshooting is implemented:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Optimize delivery throughput"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Implement monitoring dashboards"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Integrate reporting and billing"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Automate operational alerts"]}]}]},"headings":[{"value":"Verify and Troubleshoot","id":"verify-and-troubleshoot","depth":1},{"value":"When to Check Delivery Status","id":"when-to-check-delivery-status","depth":2},{"value":"Delivery and Envelope Status (Report)","id":"delivery-and-envelope-status-report","depth":2},{"value":"Delivery-Level Fields","id":"delivery-level-fields","depth":3},{"value":"Envelope-Level Results","id":"envelope-level-results","depth":3},{"value":"Platform Retry Behavior","id":"platform-retry-behavior","depth":3},{"value":"Delivery Report Failures ( logs[].key )","id":"delivery-report-failures--logskey-","depth":2},{"value":"Authorization Errors","id":"authorization-errors","depth":2},{"value":"Platform Errors","id":"platform-errors","depth":2},{"value":"Error Response Format","id":"error-response-format","depth":2},{"value":"Retry Strategy","id":"retry-strategy","depth":2},{"value":"Monitoring and Logging","id":"monitoring-and-logging","depth":2},{"value":"Best Practices","id":"best-practices","depth":2},{"value":"Next Steps","id":"next-steps","depth":2}],"frontmatter":{"seo":{"title":"Verify and Troubleshoot"}},"lastModified":"2026-05-18T07:16:00.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/getting-started/verify-delivery","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}