Consumer Data Access API

this document assumes that the reader has already created an api user and is capable of obtaining a token via the monetate auth api's refresh a token endpoint if you're unfamiliar with these steps, refer to manage api keys various privacy policies and regulations give consumers the right to request that a company provide access to all the data that the company has collected about them to help comply with these regulations, monetate provides an api endpoint that accepts a customer id that you provide and for which you can receive a response containing all the data associated to that id access endpoint make a get request to the following endpoint consumer data access endpoint https //api monetate net/api/profile/v1/{retailershortname}/{customer id} csv submit a support ticket using the {{monetatesupportcontact}} to obtain your account's retailershortname if you don't know it substitute a different customer id to access data about the customer associated with that id example request https //api monetate net/api/profile/v1/domain/customer1234 csv response the response to a successful request includes the following headers content type text/csv; charset=utf 8 content disposition attachment; filename={retailershortname} {customer id} {iso8601 timestamp} csv the body contains concatenated csvs with headers of all facts that monetate can associate with that customer id here's an example response example response < http/2 200 < date thu, 06 feb 2020 20 05 09 gmt < content type text/csv; charset=utf 8 < content length 10877 < server nginx < content disposition attachment; filename=domain customer1234 2020 02 06t20 05 09 954150 csv < content language en < vary accept language, cookie < allow get, head, options < x frame options sameorigin < expires thu, 06 feb 2020 20 05 08 gmt < cache control no cache < strict transport security max age=31536000; includesubdomains < custom target account id,mid ts,mid rnd,time,custom target id,custom target value abc1234,1123456778344,344475381,2018 10 30 16 07 58,23140,customer1234 last customer id account id,mid ts,mid rnd,customer id,first time,last time abc1234,1123456778344,344475381,customer1234,2018 10 30 16 07 58,2018 10 30 16 07 58 session account id,mid ts,mid rnd,first time,last time,page views,cart views,customer id,update time abc1234,1123456778344,344475381,2018 10 30 16 07 58,2018 10 30 16 07 58,1,0,customer1234,2018 10 30 16 07 58 cart line account id,mid ts,mid rnd,time,line,sku,pid,quantity,unit price,trk currency,trk unit price abc1234,1123456778344,344475381,2019 05 08 16 28 57,1,,product5,1,120 00,usd,120 00 custom target account id,mid ts,mid rnd,time,custom target id,custom target value abc1234,1557332443712,1136987212,2019 05 08 16 20 48,34474,segment value last customer id account id,mid ts,mid rnd,customer id,first time,last time abc1234,1557332443712,1136987212,customer1234,2019 05 08 16 26 53,2019 05 08 16 29 32 product view account id,mid ts,mid rnd,first time,pid,inventory,views,customer id,update time abc1234,1557332443712,1136987212,2019 05 08 16 21 43,product1,none,1,customer1234,2019 05 08 16 26 53 abc1234,1557332443712,1136987212,2019 05 08 16 24 07,product2,none,1,customer1234,2019 05 08 16 26 53 abc1234,1557332443712,1136987212,2019 05 08 16 24 23,product3,none,1,customer1234,2019 05 08 16 26 53 onboarded customer dataset1 retailer id,dataset id,lookup key,update time,data json abc1234,1094,customer1234,2020 02 04 01 37 18," { ""favorite sport"" hockey, ""favorite team"" ""penguins"" } " response codes the possible response codes are as follows 200 success 401 auth problem your token is invalid, your header is incorrectly formatted, or you are trying to use a token from an account from another retailer if monetate has no information it can associate with the submitted customer id, then you still receive a 200 response but with an empty body