Magento REST API response getting 404

Magento REST API response getting 404

July 10, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Magento REST API response getting 404

Debugging Magento REST API 404 Errors: A Comprehensive Guide

As a senior developer and technical blogger, I understand your frustration when trying to get Magento’s REST API to work. In this post, we’ll troubleshoot the common issue of receiving a 404 Not Found error when calling the API.

Understanding the Basics: Magento REST API Configuration

Before diving into the issue, let me briefly recap the steps you mentioned:

  1. You’ve created an admin user with appropriate permissions in the Magento backend.
  2. You successfully obtained an access token and secret using OAuth 1.0 authorization.
  3. You attempted to call the /api/rest/products endpoint directly.

The Problem: Incorrect API Endpoint Format

The primary issue lies in the format of your API calls. Let’s break down why both methods failed:

Attempt 1: Direct API Call (404 Error)

[Magentosite]/api/rest/products

This approach will not work because Magento does not expose the API directly via this URL structure.

Attempt 2: Using api.php and Specifying Type (Invalid Adapter Error)

[Magentosite]/api.php?type=rest/products

While this method is closer to being correct, it still fails due to a missing configuration. The option parameter should be used instead of type.

The Solution: Correcting the API Endpoint

To access Magento’s REST API successfully in your version (1.9.0.1), you need to follow these steps:

Step 1: Enable the Required Apache Configuration

You’re already on the right track by enabling the appropriate permissions in your Apache configuration file (/etc/apache2/sites-available/default):

<Directory /var/www/mymagento/>
    Options Indexes FollowSymLinks
     AllowOverride All
</Directory>

This ensures that Magento has the necessary permissions to handle API requests.

Step 2: Use the Correct API Endpoint Format

The correct format for calling a REST API in Magento 1.9 is:

[Magentosite]/api/rest/[resource]

Replace [resource] with your desired resource, such as products, categories, or customers.

Step 3: Apply the Basic Authentication Header

When making requests, include the access token and secret in the Authorization header using the OAuth 1.0a scheme:

Authorization: OAuth oauth_consumer_key="[customerKey]", oauth_token="[accessToken]", oauth_signature_method="HmacSHA256", oauth_timestamp="[timestamp]", oauth_nonce="[nonce]", oauth_version="1.0"

Remember to replace the placeholders with your actual access token, secret, timestamp, and nonce values.

Best Practices for Magento REST API

To ensure smooth integration and security:

  • Always use HTTPS for all API communications.
  • Apply appropriate rate limiting to prevent API abuse.
  • Regularly update your Magento version to benefit from bug fixes and improved stability.
  • Consider using a third-party tool or extension (like Amasty’s Advanced REST API) for enhanced functionality.

Conclusion

In summary, resolving the 404 Not Found error when working with Magento’s REST API involves:

  1. Enabling the correct Apache configuration permissions.
  2. Using the appropriate endpoint format (/api/rest/[resource]).
  3. Applying basic authentication using OAuth 1.0a in your request headers.

By following these steps and best practices, you should be able to successfully integrate and work with Magento’s REST API in your projects. If you have further questions or need assistance with specific implementation details, don’t hesitate to explore the Magento REST API documentation for more guidance.

Happy coding!

Magento 1 Catalog Security API

Our network