{ "variable": [ { "id": "baseUrl", "key": "baseUrl", "type": "string", "name": "string", "value": "api.brandtrack.fm" } ], "info": { "name": "Brandtrack API Documentation", "_postman_id": "fd1d0309-851f-4635-969f-deb0dd852904", "description": "This is the official documentation for the Brandtrack API.", "schema": "https:\/\/schema.getpostman.com\/json\/collection\/v2.1.0\/collection.json" }, "item": [ { "name": "Accounts", "description": "", "item": [ { "name": "List accounts", "request": { "url": { "host": "{{baseUrl}}", "path": "v2\/accounts", "query": [ { "key": "page", "value": "1", "description": "The page requested. Default to 1.", "disabled": false }, { "key": "per_page", "value": "100", "description": "The number of items per page. Default to 25.", "disabled": false }, { "key": "order_by", "value": "id", "description": "The field to order the results by. Default to id.", "disabled": false }, { "key": "direction", "value": "desc", "description": "The direction method to sort results. Default to asc.", "disabled": false } ], "raw": "{{baseUrl}}\/v2\/accounts?page=1&per_page=100&order_by=id&direction=desc" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Return a paginated list of accounts available for the authenticated user." }, "response": [] }, { "name": "Get an account by its ID", "request": { "url": { "host": "{{baseUrl}}", "path": "v2\/accounts\/:id", "query": [ { "key": "using_account_id", "value": "", "description": "Set this ID to filter records only to this particular account. By not providing anything, results from all accounts will be returned. Default to null.", "disabled": true } ], "raw": "{{baseUrl}}\/v2\/accounts\/:id?using_account_id=", "variable": [ { "id": "id", "key": "id", "value": "19120", "description": "The ID of the account." } ] }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Return a single account by its ID, if available to the authenticated user." }, "response": [ { "header": [], "code": 404, "body": "{\"message\":\"404 Not Found\",\"status_code\":404}", "name": "Wrong ID" } ] }, { "name": "Update an account", "request": { "url": { "host": "{{baseUrl}}", "path": "v2\/accounts\/:id", "query": [], "raw": "{{baseUrl}}\/v2\/accounts\/:id", "variable": [ { "id": "id", "key": "id", "value": "19120", "description": "The ID of the account." } ] }, "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"name\":\"lmgyeixauzqovl\"}" }, "description": "Only values provided in the request will be updated." }, "response": [ { "header": [], "code": 200, "body": "{\"data\":{\"id\":19120,\"name\":\"John's Bakery US\",\"country\":\"US\",\"suspended\":false,\"source\":null}}", "name": "Success" }, { "header": [], "code": 403, "body": "{\"message\":\"This action is unauthorized.\",\"status_code\":403}", "name": "Wrong ID" } ] }, { "name": "Handle account suspension status", "request": { "url": { "host": "{{baseUrl}}", "path": "v2\/accounts\/:id\/suspension", "query": [], "raw": "{{baseUrl}}\/v2\/accounts\/:id\/suspension", "variable": [ { "id": "id", "key": "id", "value": "19120", "description": "The ID of the account." } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"suspended\":false}" }, "description": "By providing the bool value, you can set or unset the suspension status for an account." }, "response": [ { "header": [], "code": 200, "body": "{\"data\":{\"id\":19120,\"name\":\"John's Bakery US\",\"country\":\"US\",\"suspended\":false,\"source\":null}}", "name": "Success" }, { "header": [], "code": 404, "body": "{\"message\":\"404 Not Found\",\"status_code\":404}", "name": "Wrong ID" }, { "header": [], "code": 409, "body": "{\"message\":\"You can't set a suspension to an already suspended account.\",\"status_code\":409}", "name": "Suspension issue" } ] } ] }, { "name": "Subscriptions", "description": "", "item": [ { "name": "List subscriptions", "request": { "url": { "host": "{{baseUrl}}", "path": "v2\/subscriptions", "query": [ { "key": "page", "value": "1", "description": "The page requested. Default to 1.", "disabled": false }, { "key": "per_page", "value": "100", "description": "The number of items per page. Default to 25.", "disabled": false }, { "key": "order_by", "value": "id", "description": "The field to order the results by. Default to id.", "disabled": false }, { "key": "direction", "value": "desc", "description": "The direction method to sort results. Default to asc.", "disabled": false } ], "raw": "{{baseUrl}}\/v2\/subscriptions?page=1&per_page=100&order_by=id&direction=desc" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Return a paginated list of subscriptions available for the authenticated user." }, "response": [] }, { "name": "Get a subscription by its ID", "request": { "url": { "host": "{{baseUrl}}", "path": "v2\/subscriptions\/:id", "query": [ { "key": "using_account_id", "value": "", "description": "Set this ID to filter records only to this particular account. By not providing anything, results from all accounts will be returned. Default to null.", "disabled": true } ], "raw": "{{baseUrl}}\/v2\/subscriptions\/:id?using_account_id=", "variable": [ { "id": "id", "key": "id", "value": "5392", "description": "The ID of the subscription." } ] }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Return a single subscription by its ID, if available to the authenticated user." }, "response": [ { "header": [], "code": 404, "body": "{\"message\":\"404 Not Found\",\"status_code\":404}", "name": "Wrong ID" } ] } ] }, { "name": "Users", "description": "", "item": [ { "name": "List users", "request": { "url": { "host": "{{baseUrl}}", "path": "v2\/users", "query": [ { "key": "page", "value": "1", "description": "The page requested. Default to 1.", "disabled": false }, { "key": "per_page", "value": "100", "description": "The number of items per page. Default to 25.", "disabled": false }, { "key": "order_by", "value": "id", "description": "The field to order the results by. Default to id.", "disabled": false }, { "key": "direction", "value": "desc", "description": "The direction method to sort results. Default to asc.", "disabled": false } ], "raw": "{{baseUrl}}\/v2\/users?page=1&per_page=100&order_by=id&direction=desc" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Return a paginated list of users available for the authenticated user." }, "response": [] }, { "name": "Get a user by its ID", "request": { "url": { "host": "{{baseUrl}}", "path": "v2\/users\/:id", "query": [ { "key": "page", "value": "1", "description": "The page requested. Default to 1.", "disabled": false }, { "key": "per_page", "value": "100", "description": "The number of items per page. Default to 25.", "disabled": false }, { "key": "order_by", "value": "id", "description": "The field to order the results by. Default to id.", "disabled": false }, { "key": "direction", "value": "desc", "description": "The direction method to sort results. Default to asc.", "disabled": false } ], "raw": "{{baseUrl}}\/v2\/users\/:id?page=1&per_page=100&order_by=id&direction=desc", "variable": [ { "id": "id", "key": "id", "value": "18782", "description": "The ID of the user." } ] }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Return a single user by its ID, if available to the authenticated user." }, "response": [ { "header": [], "code": 404, "body": "{\"message\":\"404 Not Found\",\"status_code\":404}", "name": "Wrong ID" } ] }, { "name": "Invites a user to the platform", "request": { "url": { "host": "{{baseUrl}}", "path": "v2\/users", "query": [], "raw": "{{baseUrl}}\/v2\/users" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"account_id\":19120,\"email\":\"testexample@example.com\",\"firstname\":\"John\",\"lastname\":\"Doe\",\"role_id\":74}" }, "description": "It will send automatically an email to the provided email address with a unique link to setup the user's account." }, "response": [ { "header": [], "code": 200, "body": "{\"data\":{\"id\":18782,\"uuid\":\"e66f37fd-ac0a-4cb6-adba-33196a5c6f3e\",\"email\":\"john.doe@brandtrack.fm\",\"firstname\":\"John\",\"lastname\":\"Doe\",\"phone_number\":\"+9332312323\",\"country\":\"BE\",\"role\":\"owner\",\"business_category_id\":62,\"flags\":[],\"created_at\":\"2024-07-09T13:34:16+00:00\"}}", "name": "Success" } ] }, { "name": "Create temporary auth token", "request": { "url": { "host": "{{baseUrl}}", "path": "v2\/users\/:id\/token", "query": [ { "key": "page", "value": "1", "description": "The page requested. Default to 1.", "disabled": false }, { "key": "per_page", "value": "100", "description": "The number of items per page. Default to 25.", "disabled": false }, { "key": "order_by", "value": "id", "description": "The field to order the results by. Default to id.", "disabled": false }, { "key": "direction", "value": "desc", "description": "The direction method to sort results. Default to asc.", "disabled": false } ], "raw": "{{baseUrl}}\/v2\/users\/:id\/token?page=1&per_page=100&order_by=id&direction=desc", "variable": [ { "id": "id", "key": "id", "value": "18782", "description": "The ID of the user." } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Create a one-time token that allows to access to the account by opening the link provided.\nIt lasts only 1 hour and any attempting to use this token after 1 hour will result in a 401 Unauthorized response." }, "response": [ { "header": [], "code": 200, "body": "{\"data\":{\"user_id\":123456,\"token\":\"kz1OrilDejZlzpId2kuxwu91LYdlzi2B\",\"created_at\":\"2024-08-01T16:03:50Z\",\"expires_at\":\"2024-08-01T17:03:50Z\",\"url\":\"https:\/\/api.brandtrack.fm\/login\/token\/kz1OrilDejZlzpId2kuxwu91LYdlzi2B\",\"requested_by\":7303}}", "name": "Sucess" }, { "header": [], "code": 404, "body": "{\"message\":\"404 Not Found\",\"status_code\":404}", "name": "Wrong ID" } ] }, { "name": "Handle user suspension status", "request": { "url": { "host": "{{baseUrl}}", "path": "v2\/users\/:id\/suspension", "query": [], "raw": "{{baseUrl}}\/v2\/users\/:id\/suspension", "variable": [ { "id": "id", "key": "id", "value": "13", "description": "The ID of the user." } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"suspended\":false}" }, "description": "By providing the bool value, you can set or unset the suspension status for a user." }, "response": [ { "header": [], "code": 200, "body": "{\"id\":18782,\"uuid\":\"e66f37fd-ac0a-4cb6-adba-33196a5c6f3e\",\"email\":\"john.doe@brandtrack.fm\",\"firstname\":\"John\",\"lastname\":\"Doe\",\"phone_number\":\"+9332312323\",\"country\":\"BE\",\"role\":\"owner\",\"business_category_id\":62,\"flags\":[],\"suspended\":false,\"created_at\":\"2024-07-09T13:34:16+00:00\"}", "name": "Success" }, { "header": [], "code": 404, "body": "{\"message\":\"404 Not Found\",\"status_code\":404}", "name": "Wrong ID" }, { "header": [], "code": 409, "body": "{\"message\":\"You can't set a suspension to an already suspended account.\",\"status_code\":409}", "name": "Suspension issue" } ] } ] }, { "name": "Locations", "description": "", "item": [ { "name": "List locations", "request": { "url": { "host": "{{baseUrl}}", "path": "v2\/locations", "query": [ { "key": "page", "value": "1", "description": "The page requested. Default to 1.", "disabled": false }, { "key": "per_page", "value": "100", "description": "The number of items per page. Default to 25.", "disabled": false }, { "key": "order_by", "value": "id", "description": "The field to order the results by. Default to id.", "disabled": false }, { "key": "direction", "value": "desc", "description": "The direction method to sort results. Default to asc.", "disabled": false } ], "raw": "{{baseUrl}}\/v2\/locations?page=1&per_page=100&order_by=id&direction=desc" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Return a paginated list of groups available for the authenticated user." }, "response": [] }, { "name": "Return a location by its ID", "request": { "url": { "host": "{{baseUrl}}", "path": "v2\/locations\/:id", "query": [], "raw": "{{baseUrl}}\/v2\/locations\/:id", "variable": [ { "id": "id", "key": "id", "value": "26440", "description": "The ID of the location." } ] }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Return a single location by its ID, if available to the authenticated user." }, "response": [ { "header": [], "code": 404, "body": "{\"message\":\"404 Not Found\",\"status_code\":404}", "name": "Wrong ID" } ] }, { "name": "Create a location", "request": { "url": { "host": "{{baseUrl}}", "path": "v2\/locations", "query": [], "raw": "{{baseUrl}}\/v2\/locations" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"name\":\"ojpraplsvntmeldpdkmp\",\"country\":\"cl\",\"city\":\"qdddkgyxbjgquhfvasy\",\"address\":\"hveyqazuvntjbbskxezycdto\",\"zip_code\":\"jvxfuvlanyjkwggywkw\",\"phone_number\":\"blfyghkjmrvkjofiajevi\",\"email\":\"lindsey52@example.com\",\"manager\":\"sfkrcbygpvexfpx\",\"type\":\"franchise\",\"additional_information\":\"aqlgoitxfc\"}" }, "description": "This endpoint is designed to by used by My Brandtrack users." }, "response": [ { "header": [], "code": 201, "body": "{\"data\":{\"id\":26440,\"account_id\":19120,\"name\":\"Downtown Bakery\",\"country\":\"US\",\"address\":\"176 Berry St, Brooklyn\",\"phone_number\":\"11002929\",\"email\":\"john.doe@brandtrack.fm\",\"manager\":\"John Doe\",\"created_at\":\"2024-07-31T14:38:34+00:00\",\"timezone\":\"America\/Los_Angeles\",\"type\":\"own\",\"city\":\"New York\",\"zip_code\":\"11249\",\"additional_information\":null}}", "name": "Success" }, { "header": [], "code": 403, "body": "{\"message\":\"This action is unauthorized.\",\"status_code\":403}", "name": "Wrong ID" } ] }, { "name": "Update a location", "request": { "url": { "host": "{{baseUrl}}", "path": "v2\/locations\/:id", "query": [], "raw": "{{baseUrl}}\/v2\/locations\/:id", "variable": [ { "id": "id", "key": "id", "value": "26440", "description": "The ID of the location." } ] }, "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"name\":\"xsw\",\"country\":\"ri\",\"city\":\"fkvyexjhhenjgyxsfhy\",\"address\":\"cndqkxrmxtzntfi\",\"zip_code\":\"pmczqek\",\"phone_number\":\"jjofnzimjvjdmni\",\"email\":\"collins.joesph@example.com\",\"manager\":\"pqbscnlbozwmfvhquiwfkly\",\"additional_information\":\"ktwxipkm\"}" }, "description": "Only values provided in the request will be updated." }, "response": [ { "header": [], "code": 200, "body": "{\"data\":{\"id\":26440,\"account_id\":19120,\"name\":\"Downtown Bakery\",\"country\":\"US\",\"address\":\"176 Berry St, Brooklyn\",\"phone_number\":\"11002929\",\"email\":\"john.doe@brandtrack.fm\",\"manager\":\"John Doe\",\"created_at\":\"2024-07-31T14:38:34+00:00\",\"timezone\":\"America\/Los_Angeles\",\"type\":\"own\",\"city\":\"New York\",\"zip_code\":\"11249\",\"additional_information\":null}}", "name": "Success" }, { "header": [], "code": 404, "body": "{\"message\":\"404 Not Found\",\"status_code\":404}", "name": "Wrong ID" } ] }, { "name": "Delete a location", "request": { "url": { "host": "{{baseUrl}}", "path": "v2\/locations\/:id", "query": [], "raw": "{{baseUrl}}\/v2\/locations\/:id", "variable": [ { "id": "id", "key": "id", "value": "26440", "description": "The ID of the location." } ] }, "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Delete a location using the ID. Any location with at least 1 zone related to, won't be deleted." }, "response": [ { "header": [], "code": 204, "body": "", "name": "Success" }, { "header": [], "code": 404, "body": "{\"message\":\"404 Not Found\",\"status_code\":404}", "name": "Wrong ID" } ] } ] }, { "name": "Zones", "description": "", "item": [ { "name": "List zones", "request": { "url": { "host": "{{baseUrl}}", "path": "v2\/zones", "query": [ { "key": "page", "value": "1", "description": "The page requested. Default to 1.", "disabled": false }, { "key": "per_page", "value": "100", "description": "The number of items per page. Default to 25.", "disabled": false }, { "key": "order_by", "value": "id", "description": "The field to order the results by. Default to id.", "disabled": false }, { "key": "direction", "value": "desc", "description": "The direction method to sort results. Default to asc.", "disabled": false } ], "raw": "{{baseUrl}}\/v2\/zones?page=1&per_page=100&order_by=id&direction=desc" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Return a paginated list of zones available for the authenticated user." }, "response": [] }, { "name": "Return a zone by its ID", "request": { "url": { "host": "{{baseUrl}}", "path": "v2\/zones\/:id", "query": [ { "key": "page", "value": "1", "description": "The page requested. Default to 1.", "disabled": false }, { "key": "per_page", "value": "100", "description": "The number of items per page. Default to 25.", "disabled": false }, { "key": "order_by", "value": "id", "description": "The field to order the results by. Default to id.", "disabled": false }, { "key": "direction", "value": "desc", "description": "The direction method to sort results. Default to asc.", "disabled": false } ], "raw": "{{baseUrl}}\/v2\/zones\/:id?page=1&per_page=100&order_by=id&direction=desc", "variable": [ { "id": "id", "key": "id", "value": "17351", "description": "The ID of the zone." } ] }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Return a single zone by its ID, if available to the authenticated user." }, "response": [ { "header": [], "code": 404, "body": "{\"message\":\"404 Not Found\",\"status_code\":404}", "name": "Wrong ID" } ] }, { "name": "Create a zone", "request": { "url": { "host": "{{baseUrl}}", "path": "v2\/zones", "query": [], "raw": "{{baseUrl}}\/v2\/zones" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"name\":\"wksbjvmkcdvigzoocmgbmak\",\"normalization_type\":\"2020\",\"acknowledgement\":false,\"account_id\":\"dolores\",\"smart_integration_ids\":[\"ittbqvsmn\"],\"store\":{\"name\":\"nakazflogfmasszhyfusegkj\",\"country\":\"ty\",\"type\":\"franchise\",\"address\":\"eeqr\",\"phone_number\":\"smunsajmopwln\",\"email\":\"heaney.clair@example.org\",\"manager\":\"ulbq\",\"timezone\":\"America\\\/Argentina\\\/San_Luis\",\"city\":\"sipfqyniwoqkxoqmqztrraaei\",\"zip_code\":\"cvlwjh\",\"additional_information\":\"pqidxjf\"},\"box\":{\"recipient\":{\"name\":\"fvzwzdfklpkdvrrjiifbesfk\",\"address\":\"tttdqjjaflmwugos\",\"city\":\"ze\",\"zip_code\":\"xxxesuwlwqwcs\",\"identification_type\":\"PASSPORT\",\"identification_number\":\"qaeu\",\"phone\":\"ukgzevuvvrfsoypg\",\"additional_information\":\"tyxnhiinvnmylehopb\"},\"connection_settings\":{\"connection_type\":\"ETHERNET\",\"network\":\"tecxxs\",\"password\":\"faiP]=(ge69'\",\"type_of_network\":\"WEP\",\"ip_protocol_assignment\":\"Static\",\"ntp_address\":\"voluptatem\",\"proxy_address\":\"aliquam\",\"additional_information\":\"qjzybxschlooesxpaijvtq\"}}}" }, "description": "It has an acknowledgement of the creation of the zone. If set to true, the zone will be created even if it is\nover the limits of the account and the subscription will be updated as well. Be aware with it, because you\nmight update your subscription.\n