Skip to content
merran
GitHubInstall

Merran documentation API & integrations

Send to the Kroger cart

POST
/api/stores/kroger/send
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.

Media typeapplication/json
object
lines
required
Array<object>
>= 1 items <= 300 items
object
itemId
required
string
packages
required
integer
>= 1 <= 99

Example

{
"lines": [
{
"itemId": "0199e8b0-5a10-7a01-8b00-00000000001d",
"packages": 1
}
]
}

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.