Amplify API Discrepancy: geo by campaign Breakdown Case-Sensitivity (DMA vs. dma)

[Mingsho Nembang]

Hello Amplify API Team,

I am writing to inquire about a potential discrepancy regarding the case-sensitivity of the breakdown parameter for the Performance Reporting geo by campaign endpoint.

• Endpoint: GET /performance/geo/bycampaign

• Parameter: breakdown

• Reference Link: https://amplifyv01.docs.apiary.io/#reference/performance-reporting/geo-by-campaign/retrieve-performance-statistics-for-all-marketer-campaigns-by-geo
  
  When attempting to use the documented value, DMA results in an error, but using the lowercase value, dma, successfully returns the requested data. 
  
  

  My Question:

  1. Is the breakdown parameter intended to be case-sensitive?

  2. If so, can you please confirm that the correct, working value for this breakdown is indeed dma (lowercase)?

  3. If dma is the required format, could the documentation be updated to reflect the correct case for this enum value?
     

  
  Sample request:
  
  curl --location --request GET 'https://api.outbrain.com/amplify/v0.1/reports/marketers/00ffea58e955df53d841c8628ba8409ec9/campaigns/geo?from=2025-02-18&to=2025-11-18&limit=500&offset=0&includeArchivedCampaigns=false&breakdown=dma' \ --header 'User-Agent: Adverity/2025.45.0.3' \ --header 'Accept-Encoding: gzip, deflate' \ --header 'Accept: */*' \ --header 'Connection: keep-alive' \ --header 'OB-TOKEN-V1: removed' Response: { "campaignResults": [], "totalCampaigns": 0 }
  

  Error message when using geo=DMA
  
  { "message": "Invalid breakdown value 'DMA', use one of the following values: country, region, dma, subregion" }

[Ales Kesar Valenko]

Hi Mingsho, 

Thank you for reaching out to the API support team. 

I'm checking with our dev team, if the parameter is case sensitive. I'll inform you shortly about our findings. 

Best regards, 

Aleš 

--
You received this message because you are subscribed to the Google Groups "Outbrain-AmplifyApi" group.
To unsubscribe from this group and stop receiving emails from it, send an email to outbrain-amplif...@googlegroups.com.
To view this discussion visit https://groups.google.com/d/msgid/outbrain-amplifyapi/7a5f52a6-16fc-4f22-8bf3-2c4517367f52n%40googlegroups.com.

--

Ales Kesar Valenko Demand Technical Solutions Team Lead e | ales.kes...@teads.com

The information in this email is confidential and intended only for the addressee(s) named above. If you are not the intended recipient, any disclosure, copying, distribution, or any action taken or omitted to be taken in reliance on it is prohibited and may be unlawful. Teads does not warrant that any attachment(s) are free from viruses or other defects and accepts no liability for any losses resulting from infected email transmission. Please note that any views expressed in this email may be those of the originator and do not necessarily reflect those of the organization. For more information or feedback, contact us here.

[Ales Kesar Valenko]

Hi Mingsho, 

I just received confirmation that the parameter dma is case sensitive and must be written with lower letters. 

We'll update the documentation shortly, to reflect this. 

If you have any additional questions, please reach out. 

Best regards, 

Aleš