The household's link imports still going

GET

/api/recipes/import/links

curl --request GET \
  --url http://localhost:3000/api/recipes/import/links \
  --cookie merran.session_token=<merran.session_token>

• Your Merran

Newest first. Finished ones aren’t listed. With an API key, it needs the imports: read permission.

Authorizations

• session
• apiKey

Responses

200

The imports.

Media typeapplication/json

object

imports

required

Array<object>

object

id

required

The import’s job.

string

status

required

string

Allowed values: queued running done failed cancelled

tag

required

string | null

total

required

integer

done

required

integer

added

required

integer

already

required

integer

failed

required

integer

stopped

required

integer

items

required

Array<object>

object

url

required

string

state

required

Where the link has got to: added, already in the library, failed (see error), or stopped before it was reached.

string

Allowed values: waiting adding added already failed stopped

recipe

required

The recipe it made, or was already.

object

id

required

string

slug

required

string

name

required

string

photo

required

string | null

error

required

string | null

createdAt

required

string format: date-time

finishedAt

required

string | null format: date-time

Example

{
  "imports": [
    {
      "id": "0199e8b0-5a10-7a01-8b00-00000000000b",
      "status": "running",
      "tag": "to try",
      "total": 2,
      "done": 1,
      "added": 1,
      "already": 0,
      "failed": 0,
      "stopped": 0,
      "items": [
        {
          "url": "https://example.com/garlic-rice",
          "state": "added",
          "recipe": {
            "id": "0199e8b0-5a10-7a01-8b00-000000000007",
            "slug": "garlic-rice",
            "name": "Garlic Rice",
            "photo": null
          },
          "error": null
        },
        {
          "url": "https://example.com/lemon-chicken",
          "state": "adding",
          "recipe": null,
          "error": null
        }
      ],
      "createdAt": "2026-10-15T18:30:00.000Z",
      "finishedAt": null
    }
  ]
}

401

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."
    }
  }
}

403

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."
    }
  }
}