getCatalog & getCollections not working error 404 not found

[thezykedev]

Welcome!

• Yes, I have searched for similar issues on GitHub and found none.

What did you do?

I was trying the routes /business/getCatalog/ and /business/getCollection/ and is not working, it gives me Error code 404

What did you expect?

I expected the output to be like in this example

for getCatalog and getCollections

What did you observe instead of what you expected?

The route appears to not exists

Screenshots/Videos

What I actually get:

Full message:
404 - "{\"status\":404,\"error\":\"Not Found\",\"response\":{\"message\":[\"Cannot GET /business/getCatalog/Instancia1\"]}}"

Request:
{ "body": { "number": "5511988888888" }, "headers": { "apikey": "myapikey", "accept": "application/json,text/html,application/xhtml+xml,application/xml,text/*;q=0.9, image/*;q=0.8, */*;q=0.7" }, "method": "GET", "uri": "https://myserver.com/business/getCatalog/instancia1", "gzip": true, "rejectUnauthorized": true, "followRedirect": true, "resolveWithFullResponse": true, "followAllRedirects": true, "timeout": 300000, "encoding": null, "json": false, "useStream": true }

Which version of the API are you using?

2.3.3

What is your environment?

Docker

Other environment specifications

evoapicloud/evolution-api:v2.3.3

If applicable, paste the log output

No response

Additional Notes

No response

[MELUAUTOMACOES]

✅ Explanation

That 404 - "Cannot GET /business/getCatalog/instancia1" means the route isn’t available in the version of Evolution API they’re running.

The /business/getCatalog/{instance} and /business/getCollections/{instance} endpoints were only added recently (PR #1214, merged in February 2025) and are part of the develop branch — they don’t exist in versions prior to that (for example, v 2.3.3).

🧩 How the working setup looks

Here’s an example that works on a recent build (≥ v 2.4 or any image built from the develop branch):

curl -X POST "https://api.example.com/business/getCatalog/MyStoreInstance"
-H "Content-Type: application/json"
-H "apikey: ABCD1234-5678-ABCD-9999-EXAMPLEKEY"
-d '{"number":"5511999999999"}'

Expected output:

{
"wuid": "5511999999999@s.whatsapp.net",
"isBusiness": true,
"catalogLength": 5,
"catalog": [
{ "id": "1234567890", "name": "Product A", "price": 49900, "currency": "BRL" }
]
}

🧠 Why you’re getting 404

In your log, you’re using GET — but the route requires POST with a JSON body.

The version you mentioned (2.3.3) is older than the one that includes /business/....
Earlier versions only had routes like /chat/getCatalog (internal) or none at all.

🧰 How to fix

Option 1 – Update to the develop image:

docker run -d
--name evolution-api-dev
-p 8080:8080
-e AUTHENTICATION_API_KEY=MY_KEY
ghcr.io/evolution-api/evolution-api:develop

Then try again with:

curl -X POST "http://localhost:8080/business/getCatalog/MyStoreInstance"
-H "Content-Type: application/json"
-H "apikey: MY_KEY"
-d '{"number":"5511999999999"}'

Option 2 – If you can’t update:
You can only use the older /chat/fetchCatalogs/{instance} route (less detailed) or wait for the new business endpoints to be released in the next stable tag.

✅ TL;DR

/business/getCatalog → exists only on develop builds or >= v 2.4

Use POST, not GET

Include a JSON body: { "number": "<business_number>" }

Make sure your instance name matches exactly what’s registered in /instance/list

Here's the result I got

[
  {
    "wuid": "554199999999@s.whatsapp.net",
    "numberExists": true,
    "isBusiness": true,
    "catalogLength": 5,
    "catalog": [
      {
        "id": "24779934535000366",
        "imageUrls": {
          "requested": "https://media-ams2-1.cdn.whatsapp.net/v/t45.5328-4/564386088_1346048387305989_6960532898915856845_n.jpg?stp=dst-jpg_p100x100_tt6&ccb=1-7&_nc_sid=657aed&_nc_ohc=km6hECLoT7MQ7kNvwGFfy6q&_nc_oc=AdmeUAm9T-PIM2w8jimsQeVLO3eWM8IWT5nRwGqZ0Tx2lkQK0msFxlneQu_P2fQQ_vrgP-ExAWjYm-zqxuTEvKfl&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=media-ams2-1.cdn.whatsapp.net&_nc_gid=bnvrg-Ns0mKd5F2xWynxcg&oh=01_Q5Aa2wFstO-RQiRpHAIdDm4AORb18_2qmHHcSRqc8ckUYmKkmg&oe=68F96C94",
          "original": "https://media-ams2-1.cdn.whatsapp.net/v/t45.5328-4/564386088_1346048387305989_6960532898915856845_n.jpg?ccb=1-7&_nc_sid=657aed&_nc_ohc=km6hECLoT7MQ7kNvwGFfy6q&_nc_oc=AdmeUAm9T-PIM2w8jimsQeVLO3eWM8IWT5nRwGqZ0Tx2lkQK0msFxlneQu_P2fQQ_vrgP-ExAWjYm-zqxuTEvKfl&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=media-ams2-1.cdn.whatsapp.net&_nc_gid=bnvrg-Ns0mKd5F2xWynxcg&oh=01_Q5Aa2wHXQk2eU6lm5BgCi0cjm7v_4gqg1HD9qMayFbMwBm4xHg&oe=68F96C94"
        },
        "reviewStatus": {
          "whatsapp": "APPROVED"
        },
        "availability": "in stock",
        "name": "LAÇO ESTELA",
        "description": "🌺 Laço em linho azul marinho, com bordado artesanal de rosas lilás, rosa e brancas 🌺\nElegante e marcante, o bordado de rosas feito à mão simboliza delicadeza e confiança. O contraste do azul marinho com as flores bordadas torna este laço uma peça sofisticada, ideal para quem deseja se destacar com estilo refinado",
        "price": 49900,
        "currency": "BRL",
        "isHidden": false
      }
    ]
  }
]
```