Merran documentation API & integrations
Send to the Kroger cart
POST
/api/stores/kroger/send
const url = 'http://localhost:3000/api/stores/kroger/send';const options = { method: 'POST', headers: { cookie: 'merran.session_token=<merran.session_token>', 'Content-Type': 'application/json' }, body: '{"lines":[{"itemId":"0199e8b0-5a10-7a01-8b00-00000000001d","packages":1}]}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url http://localhost:3000/api/stores/kroger/send \ --header 'Content-Type: application/json' \ --cookie merran.session_token=<merran.session_token> \ --data '{ "lines": [ { "itemId": "0199e8b0-5a10-7a01-8b00-00000000001d", "packages": 1 } ] }'Adds the lines given to the linked account’s cart, so many of each, by barcode. Their products are kept as the household’s from now on. Kroger’s API can only add to a cart: checking out is on Kroger’s site. With an API key, it needs the list: write permission.
Authorizations
Section titled “Authorizations”Request Bodyrequired
Section titled “Request Bodyrequired”Media typeapplication/json
object
lines
required
Array<object>
object
itemId
required
string
packages
required
integer
Example
{ "lines": [ { "itemId": "0199e8b0-5a10-7a01-8b00-00000000001d", "packages": 1 } ]}Responses
Section titled “Responses”Sent.
Media typeapplication/json
object
sent
required
integer
store
required
string
cartUrl
required
The store’s cart, to check out.
string
Example
{ "sent": 1, "store": "Fry's", "cartUrl": "https://www.frysfood.com/cart"}None of them has a product.
Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
fields
object
key
additional properties
string
Example
{ "error": { "code": "not_found", "message": "There's nothing here.", "fields": { "name": "Give it a name." } }}Not signed in.
Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
fields
object
key
additional properties
string
Example
{ "error": { "code": "not_found", "message": "There's nothing here.", "fields": { "name": "Give it a name." } }}Not allowed.
Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
fields
object
key
additional properties
string
Example
{ "error": { "code": "not_found", "message": "There's nothing here.", "fields": { "name": "Give it a name." } }}Kroger stopped taking the account: link it again.
Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
fields
object
key
additional properties
string
Example
{ "error": { "code": "not_found", "message": "There's nothing here.", "fields": { "name": "Give it a name." } }}© 2026 Kyle Johnson. Documentation: CC BY 4.0. Merran: AGPL-3.0-or-later.