# Coverage demoted 2026-10-07 (roadmap#942, PLAN.md Stage A): this file was written by an API Evangelist
# sweep and names no billing unit, meters or pricing category read from the provider — it restates the
# FinOps framework. It is `x-coverage: unmeasured`, and the FOCUS alignment it claimed has been removed.
x-coverage: unmeasured
specification: FinOps Framework
specificationVersion: '1.0'
provider: DHL
providerId: dhl
publisherName: DHL
serviceCategory: API
created: '2026-05-04'
# Provenance stamped 2026-08-11: this artifact was written by the API Evangelist
# bulk sweep dated 2026-05-04, not harvested from the provider. See roadmap#35.
method: generated
modified: '2026-05-04'
tags:
  - Freight
  - Logistics
  - Shipping
  - eCommerce
  - Tracking
  - FinOps
  - Cost Management
  - FOCUS
description: FinOps framework definition for the DHL API surface. Provides a FOCUS-aligned mapping for
  cost allocation, usage measurement, and unit-economics reporting across the provider's APIs.
principles:
  - name: Visibility
    description: Make API consumption costs visible to engineering, product, and finance teams in near
      real-time.
  - name: Allocation
    description: Tag every chargeable API call with the consuming team, environment, application, and
      feature so cost can be allocated.
  - name: Optimization
    description: Continuously evaluate request patterns, caching, batching, and tier selection to reduce
      cost per useful unit of work.
  - name: Accountability
    description: Establish budget owners and chargeback or showback flows for each consuming team.
domains:
  - name: Understand Usage and Cost
    capabilities:
      - Data Ingestion
      - Allocation
      - Reporting and Analytics
      - Anomaly Management
  - name: Quantify Business Value
    capabilities:
      - Planning and Estimating
      - Forecasting
      - Budgeting
      - Benchmarking
      - Unit Economics
  - name: Optimize Usage and Cost
    capabilities:
      - Architecting for Cloud
      - Rate Optimization
      - Workload Optimization
      - Cloud Sustainability
      - Licensing and SaaS
  - name: Manage the FinOps Practice
    capabilities:
      - FinOps Practice Operations
      - FinOps Education and Enablement
      - Invoicing and Chargeback
      - Onboarding Workloads
      - Intersecting Disciplines
billingModel:
  pricingCategory: Usage-Based
  billingFrequency: Monthly
  billingCurrency: USD
  chargeCategories:
    - Usage
    - Purchase
    - Tax
    - Credit
    - Adjustment
  chargeFrequency: Recurring
focusColumns:
  ServiceName: DHL
  ServiceCategory: Developer Tools / API
  ProviderName: DHL
  PublisherName: DHL
  InvoiceIssuerName: DHL
  PricingCategory: Usage-Based
  PricingUnit: request
  BillingCurrency: USD
  ChargeCategory: Usage
meters:
  - name: api_requests
    description: Count of billable API requests
    unit: request
    aggregation: sum
    dimensions:
      - api
      - endpoint
      - tier
      - region
      - consumer
  - name: data_egress
    description: Bytes returned over the network in API responses
    unit: GB
    aggregation: sum
    dimensions:
      - api
      - region
      - consumer
  - name: compute_seconds
    description: Server-side compute consumed by the request, where applicable
    unit: second
    aggregation: sum
    dimensions:
      - api
      - endpoint
      - tier
apis:
  - name: Location Finder Unified
    baseURL: ''
    tags:
      - Locations
      - Logistics
    serviceName: Location Finder Unified
    serviceCategory: API
  - name: Shipment Tracking Unified
    baseURL: ''
    tags:
      - Tracking
      - Shipping
    serviceName: Shipment Tracking Unified
    serviceCategory: API
  - name: Shipment Tracking Unified Push
    baseURL: ''
    tags:
      - Tracking
      - Push
    serviceName: Shipment Tracking Unified Push
    serviceCategory: API
  - name: User Guide DHL eCommerce Americas
    baseURL: ''
    tags:
      - eCommerce
      - Americas
    serviceName: User Guide DHL eCommerce Americas
    serviceCategory: API
  - name: Additional Services DHL Freight
    baseURL: ''
    tags:
      - Freight
      - Services
    serviceName: Additional Services DHL Freight
    serviceCategory: API
  - name: Authentication DHL eCommerce Americas
    baseURL: ''
    tags:
      - Authentication
      - eCommerce
    serviceName: Authentication DHL eCommerce Americas
    serviceCategory: API
  - name: Authentication API DHL Freight
    baseURL: ''
    tags:
      - Authentication
      - Freight
    serviceName: Authentication API DHL Freight
    serviceCategory: API
  - name: Authentication API Post Parcel Germany
    baseURL: ''
    tags:
      - Authentication
      - Germany
    serviceName: Authentication API Post Parcel Germany
    serviceCategory: API
  - name: Changelog DHL eCommerce Americas
    baseURL: ''
    tags:
      - Changelog
      - eCommerce
    serviceName: Changelog DHL eCommerce Americas
    serviceCategory: API
  - name: DATAFACTORY AUTOCOMPLETE 2.0
    baseURL: ''
    tags:
      - Address
      - Germany
    serviceName: DATAFACTORY AUTOCOMPLETE 2.0
    serviceCategory: API
  - name: Deutsche Post Hybrid Mail Shipments E-POST
    baseURL: ''
    tags:
      - Mail
      - Germany
    serviceName: Deutsche Post Hybrid Mail Shipments E-POST
    serviceCategory: API
  - name: Deutsche Post International
    baseURL: ''
    tags:
      - Mail
      - International
    serviceName: Deutsche Post International
    serviceCategory: API
  - name: Deutsche Post INTERNETMARKE
    baseURL: ''
    tags:
      - Postage
      - Germany
    serviceName: Deutsche Post INTERNETMARKE
    serviceCategory: API
  - name: Deutsche Post Order Management AM
    baseURL: ''
    tags:
      - Orders
      - Germany
    serviceName: Deutsche Post Order Management AM
    serviceCategory: API
  - name: Deutsche Post Print-Mailing Dispatch Preparation
    baseURL: ''
    tags:
      - Marketing
      - Mail
    serviceName: Deutsche Post Print-Mailing Dispatch Preparation
    serviceCategory: API
  - name: Deutsche Post Print-Mailing Targeting
    baseURL: ''
    tags:
      - Marketing
      - Targeting
    serviceName: Deutsche Post Print-Mailing Targeting
    serviceCategory: API
  - name: DHL eCommerce Europe eConnect
    baseURL: ''
    tags:
      - eCommerce
      - Europe
    serviceName: DHL eCommerce Europe eConnect
    serviceCategory: API
  - name: DHL eCommerce Europe eConnect Beta
    baseURL: ''
    tags:
      - eCommerce
      - Beta
    serviceName: DHL eCommerce Europe eConnect Beta
    serviceCategory: API
  - name: DHL Parcel DE Pickup
    baseURL: ''
    tags:
      - Pickup
      - Germany
    serviceName: DHL Parcel DE Pickup
    serviceCategory: API
  - name: DHL Parcel DE Postnumber
    baseURL: ''
    tags:
      - Validation
      - Germany
    serviceName: DHL Parcel DE Postnumber
    serviceCategory: API
  - name: DHL Parcel DE Private Shipping
    baseURL: ''
    tags:
      - Shipping
      - Germany
    serviceName: DHL Parcel DE Private Shipping
    serviceCategory: API
  - name: DHL Parcel DE Returns
    baseURL: ''
    tags:
      - Returns
      - Germany
    serviceName: DHL Parcel DE Returns
    serviceCategory: API
  - name: DHL Parcel DE Shipping
    baseURL: ''
    tags:
      - Shipping
      - Germany
    serviceName: DHL Parcel DE Shipping
    serviceCategory: API
  - name: DHL Parcel DE Tracking
    baseURL: ''
    tags:
      - Tracking
      - Germany
    serviceName: DHL Parcel DE Tracking
    serviceCategory: API
  - name: Document DHL Global Forwarding
    baseURL: ''
    tags:
      - Documents
      - Forwarding
    serviceName: Document DHL Global Forwarding
    serviceCategory: API
  - name: Duty and Tax DHL eCommerce Americas
    baseURL: ''
    tags:
      - Duty
      - Tax
    serviceName: Duty and Tax DHL eCommerce Americas
    serviceCategory: API
  - name: Duty and Tax Calculator Unified
    baseURL: ''
    tags:
      - Duty
      - Tax
    serviceName: Duty and Tax Calculator Unified
    serviceCategory: API
  - name: DHL eCommerce UK
    baseURL: ''
    tags:
      - eCommerce
      - United Kingdom
    serviceName: DHL eCommerce UK
    serviceCategory: API
  - name: Parcel EU BE LU NL
    baseURL: ''
    tags:
      - Parcel
      - Europe
    serviceName: Parcel EU BE LU NL
    serviceCategory: API
  - name: Pickup Cancellation DHL eCommerce India
    baseURL: ''
    tags:
      - Pickup
      - India
    serviceName: Pickup Cancellation DHL eCommerce India
    serviceCategory: API
  - name: Price Quote DHL Freight
    baseURL: ''
    tags:
      - Pricing
      - Freight
    serviceName: Price Quote DHL Freight
    serviceCategory: API
  - name: Print DHL Freight
    baseURL: ''
    tags:
      - Print
      - Freight
    serviceName: Print DHL Freight
    serviceCategory: API
  - name: Product DHL Freight
    baseURL: ''
    tags:
      - Products
      - Freight
    serviceName: Product DHL Freight
    serviceCategory: API
  - name: Product and Sub-Product Pickup Detail DHL eCommerce India
    baseURL: ''
    tags:
      - Products
      - India
    serviceName: Product and Sub-Product Pickup Detail DHL eCommerce India
    serviceCategory: API
  - name: Product Finder DHL eCommerce Americas
    baseURL: ''
    tags:
      - Products
      - Americas
    serviceName: Product Finder DHL eCommerce Americas
    serviceCategory: API
  - name: Products API Post Parcel Germany
    baseURL: ''
    tags:
      - Products
      - Germany
    serviceName: Products API Post Parcel Germany
    serviceCategory: API
  - name: Push API DHL Global Forwarding
    baseURL: ''
    tags:
      - Push
      - Forwarding
    serviceName: Push API DHL Global Forwarding
    serviceCategory: API
  - name: References DHL eCommerce Americas
    baseURL: ''
    tags:
      - Reference
      - eCommerce
    serviceName: References DHL eCommerce Americas
    serviceCategory: API
  - name: Registration for Pickup DHL eCommerce India
    baseURL: ''
    tags:
      - Pickup
      - India
    serviceName: Registration for Pickup DHL eCommerce India
    serviceCategory: API
  - name: Return Label DHL eCommerce Americas
    baseURL: ''
    tags:
      - Returns
      - Americas
    serviceName: Return Label DHL eCommerce Americas
    serviceCategory: API
  - name: Shipment Booking DHL Freight
    baseURL: ''
    tags:
      - Booking
      - Freight
    serviceName: Shipment Booking DHL Freight
    serviceCategory: API
  - name: Shipment Booking DHL Global Forwarding
    baseURL: ''
    tags:
      - Booking
      - Forwarding
    serviceName: Shipment Booking DHL Global Forwarding
    serviceCategory: API
  - name: Shipment Label DHL Global Forwarding
    baseURL: ''
    tags:
      - Labels
      - Forwarding
    serviceName: Shipment Label DHL Global Forwarding
    serviceCategory: API
  - name: Shipment Status DHL Global Forwarding
    baseURL: ''
    tags:
      - Status
      - Forwarding
    serviceName: Shipment Status DHL Global Forwarding
    serviceCategory: API
  - name: Shipment Tracking DHL eCommerce India
    baseURL: ''
    tags:
      - Tracking
      - India
    serviceName: Shipment Tracking DHL eCommerce India
    serviceCategory: API
  - name: Shipment Tracking v2 DHL Global Forwarding
    baseURL: ''
    tags:
      - Tracking
      - Forwarding
    serviceName: Shipment Tracking v2 DHL Global Forwarding
    serviceCategory: API
  - name: Time Table DHL Freight
    baseURL: ''
    tags:
      - Schedule
      - Freight
    serviceName: Time Table DHL Freight
    serviceCategory: API
  - name: Tracking DHL eCommerce Americas
    baseURL: ''
    tags:
      - Tracking
      - Americas
    serviceName: Tracking DHL eCommerce Americas
    serviceCategory: API
unitEconomics:
  - name: Cost per 1K Requests
    metric: billed_cost / (api_requests / 1000)
  - name: Cost per Active Consumer
    metric: billed_cost / active_consumers
maintainers:
  - FN: Kin Lane
    email: kin@apievangelist.com