Skip to content

Raw API Requests

Jump to bottom
Mr. Bubbles edited this page Feb 13, 2024 · 11 revisions

A collection of API requests that were recorded between the Bring App and the REST API. These are used or may be used in the future in the Bring API library.

Refresh Auth Token

POST https://api.getbring.com/rest/v2/bringauth/token HTTP/2.0
accept: application/json
x-bring-api-key: cof4Nc6D8saplXjE3h3HXqHH8m7VU2i1Gs0g85Sp
x-bring-version: 303480392
x-bring-client: android
x-bring-application: bring
x-bring-client-instance-id: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx
x-bring-client-timezone: Europe/Berlin
user-agent: Bring!/4.57.0 (ch.publisheria.bring; versionCode:303480392; build:196; android 33) okhttp/4.9.1
x-bring-user-uuid: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
x-bring-user-ad-tracking-enabled: true
x-bring-user-ad-id: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
x-bring-country: DE
accept-language: de-DE
content-type: application/x-www-form-urlencoded
content-length: 520
accept-encoding: gzip

grant_type=refresh_token&refresh_token=xxxxxxxxxxxxxxxxxxxxxxxxxxxxx

HTTP/2.0 200
date: Fri, 02 Feb 2024 01:43:17 GMT
content-type: application/json
server: Apache/2.4.58 () OpenSSL/1.0.2k-fips
vary: Origin,Accept-Encoding
x-amzn-trace-id: Root=x-xxxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxx;
content-length: 1040

{
  "access_token":"xxxxx",
  "token_type":"Bearer",
  "expires_in":604799
}

Batch update of items on a shopping List

This is the method used by the Android App to manipulate items on the lists

PUT https://api.getbring.com/rest/v2/bringlists/{list_uuid}/items HTTP/2.0
x-bring-api-key: cof4Nc6D8saplXjE3h3HXqHH8m7VU2i1Gs0g85Sp
x-bring-version: 303480400
x-bring-client: android
x-bring-application: bring
x-bring-client-instance-id: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx
x-bring-client-timezone: Europe/Berlin
user-agent: Bring!/4.58.3 (ch.publisheria.bring; versionCode:303480400; build:200; android 33) okhttp/4.9.1
x-bring-user-uuid: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx
x-bring-country: DE
accept-language: de-DE
x-bring-user-ad-tracking-enabled: true
x-bring-user-ad-id: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx
authorization: Bearer 
content-type: application/json; charset=UTF-8
content-length: 708
accept-encoding: gzip

{
  "changes": [
    {
      "accuracy": "0.0",
      "altitude": "0.0",
      "itemId": "Käse",
      "latitude": "0.0",
      "longitude": "0.0",
      "operation": "TO_PURCHASE",
      "spec": "Emmentaler",
      "uuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx"
    },
    {
      "accuracy": "0.0",
      "altitude": "0.0",
      "itemId": "Käse",
      "latitude": "0.0",
      "longitude": "0.0",
      "operation": "TO_PURCHASE",
      "spec": "Blauschimmel",
      "uuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx"
    },
    {
      "accuracy": "0.0",
      "altitude": "0.0",
      "itemId": "Mehl",
      "latitude": "0.0",
      "longitude": "0.0",
      "operation": "REMOVE",
      "spec": "Dinkel",
      "uuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx"
    },
    {
      "accuracy": "0.0",
      "altitude": "0.0",
      "itemId": "Mehl",
      "latitude": "0.0",
      "longitude": "0.0",
      "operation": "REMOVE",
      "spec": "Weizen",
      "uuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx"
    }
  ],
  "sender": ""
}

Load all Lists

GET https://api.getbring.com/rest/bringusers/{list_uuid}/lists HTTP/2.0
accept: application/json
x-bring-api-key: cof4Nc6D8saplXjE3h3HXqHH8m7VU2i1Gs0g85Sp
x-bring-version: 303480400
x-bring-client: android
x-bring-application: bring
x-bring-client-instance-id: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx
x-bring-client-timezone: Europe/Berlin
user-agent: Bring!/4.58.3 (ch.publisheria.bring; versionCode:303480400; build:200; android 33) okhttp/4.9.1
x-bring-user-uuid: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx
x-bring-user-ad-tracking-enabled: true
x-bring-user-ad-id: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx
x-bring-country: DE
accept-language: de-DE
authorization: Bearer 
accept-encoding: gzip
content-length: 0



HTTP/2.0 200 
date: Tue, 13 Feb 2024 17:34:42 GMT
content-type: application/json
server: Apache/2.4.58 () OpenSSL/1.0.2k-fips
vary: Origin,Accept-Encoding
x-amzn-trace-id: Root=xxx;
etag: "-1247720605-gzip"
cache-control: no-transform
content-length: 468

{
  "lists": [
    {
      "listUuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx",
      "name": "Einkaufsliste",
      "theme": "ch.publisheria.bring.theme.home"
    },
    {
      "listUuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx",
      "name": "IKEA",
      "theme": "ch.publisheria.bring.theme.office"
    },
    {
      "listUuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx",
      "name": "Baumarkt",
      "theme": "ch.publisheria.bring.theme.hardware"
    }
  ]
}

Users of a shared list

Get Details of all users of a shared list

GET https://api.getbring.com/rest/v2/bringlists/{list_uuid}/users HTTP/2.0
accept: application/json
x-bring-api-key: cof4Nc6D8saplXjE3h3HXqHH8m7VU2i1Gs0g85Sp
x-bring-version: 303480400
x-bring-client: android
x-bring-application: bring
x-bring-client-instance-id: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx
x-bring-client-timezone: Europe/Berlin
user-agent: Bring!/4.58.3 (ch.publisheria.bring; versionCode:303480400; build:200; android 33) okhttp/4.9.1
x-bring-user-uuid: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx
x-bring-user-ad-tracking-enabled: true
x-bring-user-ad-id: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx
x-bring-country: DE
accept-language: de-DE
authorization: Bearer
accept-encoding: gzip
content-length: 0



HTTP/2.0 200 
date: Tue, 13 Feb 2024 17:46:38 GMT
content-type: application/json
server: Apache/2.4.58 () OpenSSL/1.0.2k-fips
vary: Origin,Accept-Encoding
x-amzn-trace-id: Root=xxx;
etag: "1739193834-gzip"
cache-control: no-transform
strict-transport-security: max-age=31536000 ; includeSubDomains
x-xss-protection: 1; mode=block
x-frame-options: DENY
x-content-type-options: nosniff
content-length: 747


  "users": [
    {
      "publicUuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx",
      "name": "xxxx",
      "email": "xxxx",
      "photoPath": "bring/user/portrait/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx",
      "pushEnabled": true,
      "plusTryOut": false,
      "country": "DE",
      "language": "de"
    },
    {
      "publicUuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx",
      "name": "xxx",
      "email": "xxx",
      "photoPath": "bring/user/portrait/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx",
      "pushEnabled": true,
      "plusTryOut": false,
      "country": "DE",
      "language": "de"
    },
    {
      "publicUuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx",
      "name": "xxx",
      "email": "xxx",
      "photoPath": "bring/user/portrait/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx",
      "pushEnabled": true,
      "plusTryOut": false,
      "country": "DE",
      "language": "de"
    }
  ]
}

Clone this wiki locally