API key passed as a Bearer token in the Authorization header. You can find your API Key on Your FirstPromoter Dashboard. Navigate to Settings → Integrations section → Manage API Keys
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"FirstPromoter Docs","colors":{"primary":"#2497F3","light":"#42A5F5","dark":"#1A1C25"},"logo":{"light":"https://mintcdn.com/firstpromoter/Qml53iAwCwPGiKRZ/logo/light.svg?fit=max\u0026auto=format\u0026n=Qml53iAwCwPGiKRZ\u0026q=85\u0026s=17d35344b27497f795682da8932295c9","dark":"https://mintcdn.com/firstpromoter/Qml53iAwCwPGiKRZ/logo/dark.svg?fit=max\u0026auto=format\u0026n=Qml53iAwCwPGiKRZ\u0026q=85\u0026s=ef23e747176d9a87b5ddf122595793f8"},"favicon":"https://mintcdn.com/firstpromoter/rNk-Jdvp2vdjAvd9/favicon.png?fit=max\u0026auto=format\u0026n=rNk-Jdvp2vdjAvd9\u0026q=85\u0026s=7faf17e323609b0fef661b9a9fe49ebc","navbar":{"links":[{"href":"mailto:support@firstpromoter.com","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://login.firstpromoter.com/"}},"footer":{"socials":{"x":"https://x.com/firstpromoter","linkedin":"https://www.linkedin.com/company/first-promoter"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"firstpromoter","hasAudioNarration":false,"actualSubdomain":"firstpromoter","customDomains":["docs.firstpromoter.com"],"gitSource":{"type":"github","owner":"firstpromoter","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6aeb056486e5c4288ac4ca44","collectionId":"46b1f99c-db41-4d10-8d3e-8d7eeeaa0b5e","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6aeb056486e5c4288ac4ca44"},"entitlements":{},"buildId":"6aeb056486e5c4288ac4ca44","clientVersion":"0.0.4067","searchFilterCounts":[{"language":"default","tag":"Documentation","count":213},{"language":"default","tag":"API Reference","count":81},{"language":"default","tag":"Integration Options","count":41},{"language":"default","tag":"Promoters","count":25},{"language":"default","tag":"Platform","count":23},{"language":"default","tag":"Custom","count":9},{"language":"default","tag":"Webhooks","count":9},{"language":"default","tag":"Reports","count":8},{"language":"default","tag":"Payouts","count":7},{"language":"default","tag":"Commissions","count":7}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference-v2/api-admin/promoters/get-reports-for-promoter-urls","slug":"/api-reference-v2/api-admin/promoters/get-reports-for-promoter-urls","pageMetadata":{"openapi":"openapi-v2-promoters get /promoters/{id}/urls_report","title":"Get reports for promoter URLs","description":"With this endpoint you can get the report data for a single promoter, grouped by URL. \n \u003cTip>**HTTP Request** \u003cbr/>`GET https://api.firstpromoter.com/api/v2/company/promoters/{id}/urls_report`\u003c/Tip>","href":"/api-reference-v2/api-admin/promoters/get-reports-for-promoter-urls"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n strong: \"strong\",\n ..._provideComponents(),\n ...props.components\n }, {Tip} = _components;\n if (!Tip) _missingMdxReference(\"Tip\", true);\n return _jsxs(_components.p, {\n children: [\"With this endpoint you can get the report data for a single promoter, grouped by URL.\\n\", _jsxs(Tip, {\n children: [_jsx(_components.strong, {\n children: \"HTTP Request\"\n }), \" \", _jsx(\"br\", {}), _jsx(_components.code, {\n children: \"GET https://api.firstpromoter.com/api/v2/company/promoters/{id}/urls_report\"\n })]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\nfunction _missingMdxReference(id, component) {\n throw new Error(\"Expected \" + (component ? \"component\" : \"object\") + \" `\" + id + \"` to be defined: you likely forgot to import, pass, or provide it.\");\n}\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"openapi":"openapi-v2-promoters get /promoters/{id}/urls_report","title":"Get reports for promoter URLs","description":"With this endpoint you can get the report data for a single promoter, grouped by URL. \n \u003cTip>**HTTP Request** \u003cbr/>`GET https://api.firstpromoter.com/api/v2/company/promoters/{id}/urls_report`\u003c/Tip>","href":"/api-reference-v2/api-admin/promoters/get-reports-for-promoter-urls"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/firstpromoter/8ad42af542d542c7/downloadables/fpr-prox.js"],"openApiReferenceData":{"operation":{"summary":"Get reports for promoter URLs","description":"With this endpoint you can get the report data for a single promoter, grouped by URL. \n \u003cTip>**HTTP Request** \u003cbr/>`GET https://api.firstpromoter.com/api/v2/company/promoters/{id}/urls_report`\u003c/Tip>","operationId":"getPromoterUrlsReport","tags":["Promoters"],"parameters":["f9b10529-3152-4a52-a7a2-d1ba00a7ee6a","00ed0ee3-1657-4ee9-826c-a4ea662049f4","55848cf0-4833-4fd7-8781-911ff3b4d4d6","015c9f0f-6515-4ec7-868a-58879801bd48","f122b400-8708-434d-809b-e41358d073dc","761e1ce3-b7c1-4ae8-b44e-c6e991ac5d95","7d35458c-9f95-455b-8deb-03d51664f467","f34117c0-a408-4868-a7ac-2afd8f17257e"],"responses":{"200":"614027f4-2321-44c8-a407-6849a8dff1b9","401":"ae755a62-eb76-48ec-9aa2-cddadd53d76f","403":"8a4383f4-6705-4e65-a59b-ff5d831ba824","404":"14892035-b365-4515-836f-459432afcbdd","422":"7b2756da-2495-4e51-8a2e-67d8f981b3df"},"method":"get","type":"path","servers":["ca59fc8c-15e5-4121-a53d-dbb3757de827"],"security":["379e167a-8059-427c-ac4d-525e422b308a"],"path":"/promoters/{id}/urls_report","baseUrlOptions":["https://api.firstpromoter.com/api/v2/company"],"title":"Get reports for promoter URLs","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"f9b10529-3152-4a52-a7a2-d1ba00a7ee6a":{"name":"Account-ID","in":"header","required":true,"description":"Account id. You can find your Account ID on Your FirstPromoter Dashboard. Navigate to Settings → Integrations","schema":{"type":"string","isRequired":true,"description":"Account id. You can find your Account ID on Your FirstPromoter Dashboard. Navigate to Settings → Integrations","uniqueKey":"","typeLabel":"string"}},"00ed0ee3-1657-4ee9-826c-a4ea662049f4":{"name":"id","in":"path","description":"Id of the promoter","required":true,"schema":{"type":"integer","isRequired":true,"description":"Id of the promoter","uniqueKey":"","typeLabel":"integer"}},"55848cf0-4833-4fd7-8781-911ff3b4d4d6":{"name":"columns","in":"query","required":true,"schema":{"type":"array","items":{"type":"string","enum":["clicks_count","revenue_amount","promoter_earnings_amount","referrals_count","customers_count","sales_count","refunds_count","cancelled_customers_count","referrals_to_customers_cr","clicks_to_customers_cr","clicks_to_referrals_cr","url"],"uniqueKey":"items.[INDEX]","typeLabel":"enum\u003cstring>"},"isRequired":true,"description":"Fields to be included in the report","uniqueKey":"","typeLabel":"enum\u003cstring>[]"},"description":"Fields to be included in the report"},"015c9f0f-6515-4ec7-868a-58879801bd48":{"name":"q","in":"query","required":false,"schema":{"type":"string","isRequired":false,"description":"Search query string","uniqueKey":"","typeLabel":"string"},"description":"Search query string"},"f122b400-8708-434d-809b-e41358d073dc":{"name":"group_by","in":"query","required":true,"schema":{"type":"string","enum":["day","week","month","year"],"isRequired":true,"description":"Time period grouping","uniqueKey":"","typeLabel":"enum\u003cstring>"},"description":"Time period grouping"},"761e1ce3-b7c1-4ae8-b44e-c6e991ac5d95":{"name":"start_date","in":"query","required":true,"schema":{"type":"string","format":"date-time","isRequired":true,"description":"Start date for the report period","uniqueKey":"","typeLabel":"string\u003cdate-time>"},"description":"Start date for the report period"},"7d35458c-9f95-455b-8deb-03d51664f467":{"name":"end_date","in":"query","required":true,"schema":{"type":"string","format":"date-time","isRequired":true,"description":"End date for the report period","uniqueKey":"","typeLabel":"string\u003cdate-time>"},"description":"End date for the report period"},"f34117c0-a408-4868-a7ac-2afd8f17257e":{"name":"sorting","in":"query","required":false,"schema":{"type":"object","additionalProperties":{"type":"string","enum":["asc","desc"],"uniqueKey":"additionalProperties","typeLabel":"enum\u003cstring>"},"isRequired":false,"description":"Sorting parameters","uniqueKey":"","typeLabel":"object"},"description":"Sorting parameters"}},"responses":{"614027f4-2321-44c8-a407-6849a8dff1b9":{"description":"Successful response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","uniqueKey":"items.[INDEX].url","typeLabel":"string"},"id":{"type":"string","uniqueKey":"items.[INDEX].id","typeLabel":"string"},"data":{"type":"object","properties":{"clicks_count":{"type":"integer","uniqueKey":"items.[INDEX].data.clicks_count","typeLabel":"integer"},"revenue_amount":{"type":"number","uniqueKey":"items.[INDEX].data.revenue_amount","typeLabel":"number"},"promoter_earnings_amount":{"type":"number","uniqueKey":"items.[INDEX].data.promoter_earnings_amount","typeLabel":"number"},"referrals_count":{"type":"integer","uniqueKey":"items.[INDEX].data.referrals_count","typeLabel":"integer"},"customers_count":{"type":"integer","uniqueKey":"items.[INDEX].data.customers_count","typeLabel":"integer"},"sales_count":{"type":"integer","uniqueKey":"items.[INDEX].data.sales_count","typeLabel":"integer"},"refunds_count":{"type":"integer","uniqueKey":"items.[INDEX].data.refunds_count","typeLabel":"integer"},"cancelled_customers_count":{"type":"integer","uniqueKey":"items.[INDEX].data.cancelled_customers_count","typeLabel":"integer"},"referrals_to_customers_cr":{"type":"number","uniqueKey":"items.[INDEX].data.referrals_to_customers_cr","typeLabel":"number"},"clicks_to_customers_cr":{"type":"number","uniqueKey":"items.[INDEX].data.clicks_to_customers_cr","typeLabel":"number"},"clicks_to_referrals_cr":{"type":"number","uniqueKey":"items.[INDEX].data.clicks_to_referrals_cr","typeLabel":"number"}},"uniqueKey":"items.[INDEX].data","typeLabel":"object"},"sub_data":{"type":"array","items":{"type":"object","properties":{"period":{"type":"string","uniqueKey":"items.[INDEX].sub_data.items.[INDEX].period","typeLabel":"string"},"id":{"type":"string","uniqueKey":"items.[INDEX].sub_data.items.[INDEX].id","typeLabel":"string"},"data":{"type":"object","properties":{"clicks_count":{"type":"integer","uniqueKey":"items.[INDEX].sub_data.items.[INDEX].data.clicks_count","typeLabel":"integer"},"revenue_amount":{"type":"number","uniqueKey":"items.[INDEX].sub_data.items.[INDEX].data.revenue_amount","typeLabel":"number"},"promoter_earnings_amount":{"type":"number","uniqueKey":"items.[INDEX].sub_data.items.[INDEX].data.promoter_earnings_amount","typeLabel":"number"},"referrals_count":{"type":"integer","uniqueKey":"items.[INDEX].sub_data.items.[INDEX].data.referrals_count","typeLabel":"integer"},"customers_count":{"type":"integer","uniqueKey":"items.[INDEX].sub_data.items.[INDEX].data.customers_count","typeLabel":"integer"},"sales_count":{"type":"integer","uniqueKey":"items.[INDEX].sub_data.items.[INDEX].data.sales_count","typeLabel":"integer"},"refunds_count":{"type":"integer","uniqueKey":"items.[INDEX].sub_data.items.[INDEX].data.refunds_count","typeLabel":"integer"},"cancelled_customers_count":{"type":"integer","uniqueKey":"items.[INDEX].sub_data.items.[INDEX].data.cancelled_customers_count","typeLabel":"integer"},"referrals_to_customers_cr":{"type":"number","uniqueKey":"items.[INDEX].sub_data.items.[INDEX].data.referrals_to_customers_cr","typeLabel":"number"},"clicks_to_customers_cr":{"type":"number","uniqueKey":"items.[INDEX].sub_data.items.[INDEX].data.clicks_to_customers_cr","typeLabel":"number"},"clicks_to_referrals_cr":{"type":"number","uniqueKey":"items.[INDEX].sub_data.items.[INDEX].data.clicks_to_referrals_cr","typeLabel":"number"}},"uniqueKey":"items.[INDEX].sub_data.items.[INDEX].data","typeLabel":"object"}},"uniqueKey":"items.[INDEX].sub_data.items.[INDEX]","typeLabel":"object"},"uniqueKey":"items.[INDEX].sub_data","typeLabel":"object[]"}},"uniqueKey":"items.[INDEX]","typeLabel":"object"},"uniqueKey":"","typeLabel":"object[]"},"examples":{"Example":{"title":"Example","value":[{"url":"\u003cstring>","id":"\u003cstring>","data":{"clicks_count":123,"revenue_amount":123,"promoter_earnings_amount":123,"referrals_count":123,"customers_count":123,"sales_count":123,"refunds_count":123,"cancelled_customers_count":123,"referrals_to_customers_cr":123,"clicks_to_customers_cr":123,"clicks_to_referrals_cr":123},"sub_data":[{"period":"\u003cstring>","id":"\u003cstring>","data":{"clicks_count":123,"revenue_amount":123,"promoter_earnings_amount":123,"referrals_count":123,"customers_count":123,"sales_count":123,"refunds_count":123,"cancelled_customers_count":123,"referrals_to_customers_cr":123,"clicks_to_customers_cr":123,"clicks_to_referrals_cr":123}}]}]}},"exampleType":"generated"}},"exampleType":"generated"},"ae755a62-eb76-48ec-9aa2-cddadd53d76f":{"description":"Unauthorized — the Bearer access token is missing, invalid, expired, or revoked. No JSON response body is returned.","content":{"application/json":{"schema":{"type":"object","uniqueKey":"","typeLabel":"object"},"example":{},"examples":{"Example":{"title":"Example","value":{}}},"exampleType":"examples"}},"exampleType":"examples"},"8a4383f4-6705-4e65-a59b-ff5d831ba824":{"description":"Forbidden — the authenticated user does not have permission to perform this action","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Error message","uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","description":"Error code","uniqueKey":"code","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"message":"You don't have enough rights to perform this action","code":"forbidden"},"examples":{"Example":{"title":"Example","value":{"message":"You don't have enough rights to perform this action","code":"forbidden"}}},"exampleType":"examples"}},"exampleType":"examples"},"14892035-b365-4515-836f-459432afcbdd":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Error message","uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","description":"Error code","uniqueKey":"code","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"message":"Record not found","code":"not_found"},"examples":{"Example":{"title":"Example","value":{"message":"Record not found","code":"not_found"}}},"exampleType":"examples"}},"exampleType":"examples"},"7b2756da-2495-4e51-8a2e-67d8f981b3df":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"param is missing or the value is empty: columns","uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","example":"invalid_params","uniqueKey":"code","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"param is missing or the value is empty: columns","code":"invalid_params"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"379e167a-8059-427c-ac4d-525e422b308a":{"BearerAuth":{"type":"http","scheme":"bearer","description":"API key passed as a Bearer token in the Authorization header. You can find your API Key on Your FirstPromoter Dashboard. Navigate to Settings → Integrations section → Manage API Keys","scopes":[],"schemeName":"BearerAuth"}}},"servers":{"ca59fc8c-15e5-4121-a53d-dbb3757de827":{"url":"https://api.firstpromoter.com/api/v2/company"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"API key passed as a Bearer token in the Authorization header. You can find your API Key on Your FirstPromoter Dashboard. Navigate to Settings → Integrations section → Manage API Keys","scopes":[],"schemeName":"BearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"API key passed as a Bearer token in the Authorization header. You can find your API Key on Your FirstPromoter Dashboard. Navigate to Settings → Integrations section → Manage API Keys","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"}]},"originalFileLocation":"api-reference-v2/api-admin/promoters/openapi-v2-promoters.json"},"subdomain":"firstpromoter","siteName":"FirstPromoter Docs","title":"Get reports for promoter URLs - FirstPromoter Docs","navMaps":{"firstHrefInVersion":{"v2":{"href":"/api-reference-v2/api-admin/promoters/get-reports-for-promoter-urls","matchLevel":0},"v1":{"href":"/api-reference-v1/promoters-api/create","matchLevel":2}},"firstHrefInLanguage":{}},"lastModified":"2026-09-04T11:02:17.422Z","originalFileLocation":"api-reference-v2/api-admin/promoters/get-reports-for-promoter-urls.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"With this endpoint you can get the report data for a single promoter, grouped by URL. HTTP Request GET https://api.firstpromoter.com/api/v2/company/promoters/{id}/urls_report\">\u003cmeta data-mint-head name=\"application-name\" content=\"FirstPromoter Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/firstpromoter/NHAuOTz7uXRLkEOr/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/firstpromoter/NHAuOTz7uXRLkEOr/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/firstpromoter/NHAuOTz7uXRLkEOr/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/firstpromoter/NHAuOTz7uXRLkEOr/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/firstpromoter/NHAuOTz7uXRLkEOr/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/firstpromoter/NHAuOTz7uXRLkEOr/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/firstpromoter/NHAuOTz7uXRLkEOr/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/firstpromoter/NHAuOTz7uXRLkEOr/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/firstpromoter/NHAuOTz7uXRLkEOr/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get reports for promoter URLs - FirstPromoter Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"With this endpoint you can get the report data for a single promoter, grouped by URL. HTTP Request GET https://api.firstpromoter.com/api/v2/company/promoters/{id}/urls_report\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"FirstPromoter Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.firstpromoter.com/api-reference-v2/api-admin/promoters/get-reports-for-promoter-urls\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://firstpromoter.mintlify.app/_mintlify/api/og/v2?division=Promoters\u0026amp;title=Get+reports+for+promoter+URLs\u0026amp;description=With+this+endpoint+you+can+get+the+report+data+for+a+single+promoter%2C+grouped+by+URL.+%0A+%3CTip%3E**HTTP+Request**+%3Cbr%2F%3E%60GET+https%3A%2F%2Fapi.firstpromoter.com%2Fapi%2Fv2%2Fcom\u0026amp;theme=6c5c6938239eba73fb25a5bd\u0026amp;signature=6871fee772b09b96f237e190e1b4c331aa2371238b58673abd29fdd4345860f9\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Get reports for promoter URLs - FirstPromoter Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"With this endpoint you can get the report data for a single promoter, grouped by URL. HTTP Request GET https://api.firstpromoter.com/api/v2/company/promoters/{id}/urls_report\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://firstpromoter.mintlify.app/_mintlify/api/og/v2?division=Promoters\u0026amp;title=Get+reports+for+promoter+URLs\u0026amp;description=With+this+endpoint+you+can+get+the+report+data+for+a+single+promoter%2C+grouped+by+URL.+%0A+%3CTip%3E**HTTP+Request**+%3Cbr%2F%3E%60GET+https%3A%2F%2Fapi.firstpromoter.com%2Fapi%2Fv2%2Fcom\u0026amp;theme=6c5c6938239eba73fb25a5bd\u0026amp;signature=6871fee772b09b96f237e190e1b4c331aa2371238b58673abd29fdd4345860f9\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/firstpromoter/NHAuOTz7uXRLkEOr/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"FirstPromoter Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2497F3\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.firstpromoter.com/api-reference-v2/api-admin/promoters/get-reports-for-promoter-urls\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference-v2/api-admin/promoters/get-reports-for-promoter-urls.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.firstpromoter.com/#organization\",\"name\":\"FirstPromoter Docs\",\"url\":\"https://docs.firstpromoter.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/firstpromoter/Qml53iAwCwPGiKRZ/logo/light.svg?fit=max\u0026auto=format\u0026n=Qml53iAwCwPGiKRZ\u0026q=85\u0026s=17d35344b27497f795682da8932295c9\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.firstpromoter.com#website\",\"name\":\"FirstPromoter Docs\",\"url\":\"https://docs.firstpromoter.com\",\"publisher\":{\"@id\":\"https://docs.firstpromoter.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.firstpromoter.com/api-reference-v2/api-admin/promoters/get-reports-for-promoter-urls#webpage\",\"url\":\"https://docs.firstpromoter.com/api-reference-v2/api-admin/promoters/get-reports-for-promoter-urls\",\"name\":\"Get reports for promoter URLs\",\"description\":\"With this endpoint you can get the report data for a single promoter, grouped by URL. HTTP Request GET https://api.firstpromoter.com/api/v2/company/promoters/{id}/urls_report\",\"dateModified\":\"2026-09-04T11:02:17.422Z\",\"isPartOf\":{\"@id\":\"https://docs.firstpromoter.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.firstpromoter.com/api-reference-v2/api-admin/promoters/get-reports-for-promoter-urls#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.firstpromoter.com/api-reference-v2/api-admin/promoters/get-reports-for-promoter-urls#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Promoters\",\"item\":\"https://docs.firstpromoter.com/api-reference-v2/api-admin/promoters/get-available-promoters\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get reports for promoter URLs\",\"item\":\"https://docs.firstpromoter.com/api-reference-v2/api-admin/promoters/get-reports-for-promoter-urls\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.firstpromoter.com/api-reference-v2/api-admin/promoters/get-reports-for-promoter-urls#apireference\",\"headline\":\"Get reports for promoter URLs\",\"name\":\"Get reports for promoter URLs\",\"description\":\"With this endpoint you can get the report data for a single promoter, grouped by URL. HTTP Request GET https://api.firstpromoter.com/api/v2/company/promoters/{id}/urls_report\",\"url\":\"https://docs.firstpromoter.com/api-reference-v2/api-admin/promoters/get-reports-for-promoter-urls\",\"mainEntityOfPage\":{\"@id\":\"https://docs.firstpromoter.com/api-reference-v2/api-admin/promoters/get-reports-for-promoter-urls#webpage\"},\"dateModified\":\"2026-09-04T11:02:17.422Z\",\"publisher\":{\"@id\":\"https://docs.firstpromoter.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.firstpromoter.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"FirstPromoter Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"FirstPromoter Docs","nav":{"global":null,"versions":[{"version":"v2","anchors":[{"anchor":"Documentation","icon":"book-open","tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"API Reference","groups":[{"group":"API Documentation","pages":[{"title":"FirstPromoter API v2 Introduction","sidebarTitle":"Introduction","href":"/api-reference-v2/api-admin/introduction"},{"title":"FirstPromoter API v2 Authentication","sidebarTitle":"Authentication","href":"/api-reference-v2/api-admin/authentication"}]},{"group":"Batch Processes","pages":[{"openapi":"openapi-v2-batches get /batch_processes","title":"List in progress batch processes.","href":"/api-reference-v2/api-admin/batches/list-inprogress-batch-processes"},{"openapi":"openapi-v2-batches get /batch_processes/{id}","title":"Show batch process","href":"/api-reference-v2/api-admin/batches/show-batch-process"},{"openapi":"openapi-v2-batches get /batch_processes/progress","title":"Show progress","href":"/api-reference-v2/api-admin/batches/show-progress"}]},{"group":"Tracking Api","pages":[{"title":"Tracking leads and sign-ups","openapi":"openapi-v2-tracking POST /signup","href":"/api-reference-v2/api-admin/tracking-api/leads-and-signups"},{"title":"Tracking sales and commissions","openapi":"openapi-v2-tracking POST /sale","href":"/api-reference-v2/api-admin/tracking-api/sales"},{"title":"Tracking refunds and negative commissions","openapi":"openapi-v2-tracking POST /refund","href":"/api-reference-v2/api-admin/tracking-api/refund"},{"title":"Tracking cancellations","openapi":"openapi-v2-tracking POST /cancellation","href":"/api-reference-v2/api-admin/tracking-api/cancellation"}]},{"group":"Referrals","pages":[{"openapi":"openapi-v2-referrals get /referrals","title":"Get available referrals","href":"/api-reference-v2/api-admin/referrals/get-referrals"},{"openapi":"openapi-v2-referrals get /referrals/{id}","title":"Get referral","href":"/api-reference-v2/api-admin/referrals/get-referral"},{"openapi":"openapi-v2-referrals put /referrals/{id}","title":"Update referral","href":"/api-reference-v2/api-admin/referrals/update-referral"},{"openapi":"openapi-v2-referrals post /referrals/move_to_promoter","title":"Move referrals to promoter","href":"/api-reference-v2/api-admin/referrals/move-referrals-to-promoter"},{"openapi":"openapi-v2-referrals delete /referrals","title":"Delete referrals","href":"/api-reference-v2/api-admin/referrals/delete-referrals"}]},{"group":"Promoters","pages":[{"openapi":"openapi-v2-promoters get /promoters","title":"Get available promoters","href":"/api-reference-v2/api-admin/promoters/get-available-promoters"},{"openapi":"openapi-v2-promoters post /promoters","title":"Create promoter","href":"/api-reference-v2/api-admin/promoters/create-promoter"},{"openapi":"openapi-v2-promoters get /promoters/{id}","title":"Get promoter details","href":"/api-reference-v2/api-admin/promoters/get-promoter-details"},{"openapi":"openapi-v2-promoters put /promoters/{id}","title":"Update promoter","href":"/api-reference-v2/api-admin/promoters/update-promoter"},{"openapi":"openapi-v2-promoters get /promoters/{id}/referral_links","title":"Get promoter referral links","href":"/api-reference-v2/api-admin/promoters/get-promoter-referral-links"},{"openapi":"openapi-v2-promoters get /promoters/{id}/chart_data","title":"Get data used for chart","href":"/api-reference-v2/api-admin/promoters/get-data-used-for-chart"},{"openapi":"openapi-v2-promoters get /promoters/{id}/overview_report","title":"Get reports for promoter overview","href":"/api-reference-v2/api-admin/promoters/get-reports-for-promoter-overview"},{"openapi":"openapi-v2-promoters get /promoters/{id}/traffic_sources_report","title":"Get reports for promoter traffic sources","description":"With this endpoint you can get the traffic sources report for a single promoter, broken down by source and grouped over time. \n \u003cTip>**HTTP Request** \u003cbr/>`GET https://api.firstpromoter.com/api/v2/company/promoters/{id}/traffic_sources_report`\u003c/Tip>","href":"/api-reference-v2/api-admin/promoters/get-reports-for-promoter-traffic-sources"},{"openapi":"openapi-v2-promoters get /promoters/{id}/urls_report","title":"Get reports for promoter URLs","href":"/api-reference-v2/api-admin/promoters/get-reports-for-promoter-urls"},{"openapi":"openapi-v2-promoters post /promoters/assign_parent","title":"Assign a parent promoter","description":"With this endpoint you can assign a parent promoter to your promoters. \n \u003cNote>If there are more than __5__ ids on the __ids__ param/field, the action will be processed asynchronously. The response for the batch status will most likely be `in_progress`. The available statuses are `pending`, `in_progress`, `completed`, `failed` and `stopped`\u003c/Note> \n \u003cTip>**HTTP Request** \u003cbr/>`POST https://api.firstpromoter.com/api/v2/company/promoters/assign_parent`\u003c/Tip>","href":"/api-reference-v2/api-admin/promoters/assign-parent-promoter"},{"openapi":"openapi-v2-promoters post /promoters/add_to_campaign","title":"Add promoters to campaign","href":"/api-reference-v2/api-admin/promoters/add-promoter-to-campaign"},{"openapi":"openapi-v2-promoters post /promoters/move_to_campaign","title":"Move promoters to campaign","href":"/api-reference-v2/api-admin/promoters/move-promoter-to-campaign"},{"openapi":"openapi-v2-promoters post /promoters/accept","title":"Accept promoters","href":"/api-reference-v2/api-admin/promoters/accept-promoters"},{"openapi":"openapi-v2-promoters post /promoters/reject","title":"Reject promoters","href":"/api-reference-v2/api-admin/promoters/reject-promoters"},{"openapi":"openapi-v2-promoters post /promoters/block","title":"Block promoters","href":"/api-reference-v2/api-admin/promoters/block-promoters"},{"openapi":"openapi-v2-promoters post /promoters/archive","title":"Archive promoters","href":"/api-reference-v2/api-admin/promoters/archive-promoters"},{"openapi":"openapi-v2-promoters post /promoters/restore","title":"Restore promoters","href":"/api-reference-v2/api-admin/promoters/restore-unarchived-promoters"}]},{"group":"Promoter Campaigns","pages":[{"openapi":"openapi-v2-promoter-campaigns get /promoter_campaigns","title":"Get available promoter campaigns","href":"/api-reference-v2/api-admin/promoter-campaigns/get-available-promoter-campaigns"},{"openapi":"openapi-v2-promoter-campaigns put /promoter_campaigns/{id}","title":"Update promoter campaign","href":"/api-reference-v2/api-admin/promoter-campaigns/update-promoter-campaign"}]},{"group":"Commissions","pages":[{"openapi":"openapi-v2-commissions get /commissions","title":"Get all commissions","href":"/api-reference-v2/api-admin/commissions/get-all-commissions"},{"openapi":"openapi-v2-commissions post /commissions","title":"Create a commission","href":"/api-reference-v2/api-admin/commissions/create-a-commission"},{"openapi":"openapi-v2-commissions put /commissions/{id}","title":"Update a commission","href":"/api-reference-v2/api-admin/commissions/update-a-commission"},{"openapi":"openapi-v2-commissions post /commissions/approve","title":"Approve commissions","href":"/api-reference-v2/api-admin/commissions/approve-commissions"},{"openapi":"openapi-v2-commissions post /commissions/deny","title":"Deny commissions","href":"/api-reference-v2/api-admin/commissions/deny-commissions"},{"openapi":"openapi-v2-commissions post /commissions/mark_fulfilled","title":"Mark nonmonetary commissions as fulfilled","href":"/api-reference-v2/api-admin/commissions/mark-nonmonetary-commissions-as-fulfilled"},{"openapi":"openapi-v2-commissions post /commissions/mark_unfulfilled","title":"Mark nonmonetary commissions as unfulfilled","href":"/api-reference-v2/api-admin/commissions/mark-nonmonetary-commissions-as-unfulfilled"}]},{"group":"Promo Codes","pages":[{"openapi":"openapi-v2-promocodes get /promo_codes","title":"Get promo codes","href":"/api-reference-v2/api-admin/promo-codes/get-promo-codes"},{"openapi":"openapi-v2-promocodes get /promo_codes/{id}","title":"Get promo code by id","href":"/api-reference-v2/api-admin/promo-codes/get-promo-code-by-id"},{"openapi":"openapi-v2-promocodes post /promo_codes","title":"Create promo code (Stripe Only)","href":"/api-reference-v2/api-admin/promo-codes/create-promo-code"},{"openapi":"openapi-v2-promocodes put /promo_codes/{id}","title":"Update promo code by id","href":"/api-reference-v2/api-admin/promo-codes/update-promo-code-by-id"},{"openapi":"openapi-v2-promocodes delete /promo_codes/{id}","title":"Archive promo code by id","href":"/api-reference-v2/api-admin/promo-codes/archive-promo-code-by-id"}]},{"group":"Payouts","pages":[{"openapi":"openapi-v2-payouts get /payouts","title":"Get all payouts","href":"/api-reference-v2/api-admin/payouts/get-all-payouts"},{"openapi":"openapi-v2-payouts get /payouts/stats","title":"Get payout stats","href":"/api-reference-v2/api-admin/payouts/get-payout-stats"},{"openapi":"openapi-v2-payouts get /payouts/due_stats","title":"Get due payout stats","href":"/api-reference-v2/api-admin/payouts/get-due-payout-stats"},{"openapi":"openapi-v2-payouts get /payouts/group_by_promoters","title":"Get all payouts grouped by promoters","href":"/api-reference-v2/api-admin/payouts/get-all-payouts-grouped-by-promoters"}]},{"group":"Reports","pages":[{"openapi":"openapi-v2-reports get /reports/campaigns","title":"Get reports for campaigns","href":"/api-reference-v2/api-admin/reports/get-reports-for-campaigns"},{"openapi":"openapi-v2-reports get /reports/overview","title":"Get reports for overview","href":"/api-reference-v2/api-admin/reports/get-reports-for-overview"},{"openapi":"openapi-v2-reports get /reports/promoters","title":"Get reports for promoters","href":"/api-reference-v2/api-admin/reports/get-reports-for-promoters"},{"openapi":"openapi-v2-reports get /reports/urls","title":"Get reports for URLs","href":"/api-reference-v2/api-admin/reports/get-reports-for-urls"},{"openapi":"openapi-v2-reports get /reports/traffic_sources","title":"Get reports for traffic sources","href":"/api-reference-v2/api-admin/reports/get-reports-for-traffic-sources"}]}]},{"tab":"Affiliate API Reference","hidden":true,"pages":[{"title":"Affiliate API Reference","href":"/api-reference-v2/api-affiliate/introduction"}]},{"tab":"Advanced API Reference","hidden":true,"pages":[{"title":"Advanced API Reference","href":"/api-reference-v2/api-advanced/introduction"}]}]},{"anchor":"API Reference","icon":"webhook","href":"https://docs.firstpromoter.com/api-reference-v2/api-admin/introduction"},{"anchor":"Help Center","icon":"square-question","href":"https://help.firstpromoter.com/en/"}]},{"version":"v1","pages":[{"title":"v1","href":"/api-reference-v1/promoters-api/create"}]}]},"basePath":"","title":"Get reports for promoter URLs - FirstPromoter Docs","buildId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","deploymentId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DX1Meug0.js","utils-B_OMIQVC.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-ChxhRPMa.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CuKvD8Iv.js","snippetPresets-C5d7p2hp.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CfHcE8m4.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C1zZV314.js","shallow-CmQhqCJn.js","getApiPlaygroundDisplay-YRo9s1O7.js","CodeSnippet-RN1MTdfk.js","CodeSnippets-DKLPHxJA.js","Page-BAvA99GL.js","getPastedJson-bz0M41mU.js","icon-CsmhpPrv.js","MethodPill-CNGsVE77.js","DuplicateIcon-DilfU_Z2.js","createIcon-BdsYzQck.js","DynamicMarkdown-CbqEDjbV.js","SectionHeading-O6hXpFCN.js","axios-vUo_bRtp.js","Markdown-nKm-uidQ.js","clsx-ClVdStUn.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CIQkMg3R.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-ImrFS4Fy.js"]}