Application Programming Interface (API) is the backbone of the modern world. A lot of the activities you do on digital platforms leverage APIs, and testing those APIs is key to delivering good User Experience in software and applications. If you are trying to test APIs and don’t know where to start, read on and discover 60 test cases for API testing that you can use for references. We also include a test case template so that you can actually use those test cases in your work, as well as a detailed guide on how you should test APIs.
Read More: Top 10 API Examples You Should Know
What is API Testing?
API testing is a software testing practice that tests the APIs directly — from their functionality, reliability, performance, to security. As part of integration testing, API testing aims to validate the logic of the build architecture within a short amount of time. The goal of API testing is not to check the individual software component itself, but rather the connection between them.
API testing can be performed either manually or automatically with the help of API testing tools, each comes with its own pros and cons. Generally automated API testing is preferred due to the repetitive and data-driven nature of this testing type. Also, there are many aspects of API testing, but these are 3 most common categories:
- Functional testing (checking whether the API performs its function as expected)
- Performance testing (checking how the API performs under different levels of usage)
- Security testing (checking if the APIs have any vulnerabilities or have been protected against security threats)
60 Test Cases For API Testing For Each Category
1. Test Cases For API Functional Testing
Functionality is the core of any Application Under Test (AUT), and API is no exception. Their most basic and foundational functionality is data retrieval and data sending, and API functional testing should revolve around those 2 domains. Check out the following functional test cases and see how you can apply them to your own testing project:
- Status Code Validation for Valid Requests: Verify that the API consistently returns the expected response status code, such as "200 OK," for valid and properly formatted requests.
- Authentication Handling with Invalid Credentials: Test the API's response when provided with invalid authentication credentials, ensuring it consistently returns a "401 Unauthorized" status code as expected.
- Graceful Handling of Missing or Invalid Parameters: Verify that the API handles missing or invalid request parameters gracefully and returns clear and user-friendly error messages that aid in troubleshooting.
- Input Data Validation with Malformed Data: Test the API's input validation by submitting various forms of malformed data, such as invalid email formats, and confirm that it properly rejects and responds to these inputs.
- Timeout Handling under Load: Confirm that the API correctly handles timeouts by simulating requests that take longer to process, ensuring that it remains responsive and does not hang.
- Pagination Functionality Verification: Test the API's pagination functionality by requesting specific pages of results and verifying that the responses contain the expected data and pagination information.
- Concurrency Testing without Data Corruption: Verify that the API handles concurrent requests from multiple users without data corruption or conflicts, ensuring data integrity.
- Response Format Adherence (JSON/XML): Ensure that the API consistently returns responses in the specified format (e.g., JSON or XML) and adheres to the defined schema for data structure.
- Caching Mechanism Evaluation with Repeated Requests: Evaluate the API's caching mechanism by making repeated requests and verifying that the cache headers are correctly set and honored.
- Rate Limiting Assessment: Test the API's rate limiting by sending requests at a rate that exceeds the defined limits and checking for the expected rate-limiting responses, ensuring that limits are enforced.
- HTTP Method Support for CRUD Operations: Verify that the API supports a variety of HTTP methods (GET, POST, PUT, DELETE) for Create, Read, Update, and Delete operations, and that it returns appropriate responses for each.
- Error Handling Capabilities for Meaningful Messages: Evaluate the API's error-handling capabilities by intentionally causing errors, such as invalid inputs or unexpected situations, and confirm that it consistently returns meaningful error messages for troubleshooting.
- Conditional Request Handling (If-Modified-Since, If-None-Match): Test the API's support for conditional requests using headers like If-Modified-Since and If-None-Match, ensuring that responses are handled appropriately.
- Sorting and Filtering Validation for Resource Listings: Verify that the API correctly sorts and filters resource listings based on specified parameters, maintaining data accuracy.
- Handling Long or Complex Data without Data Corruption: Ensure that the API properly handles long or complex strings, such as URLs or text fields, without truncating or corrupting the data.
- Content Negotiation Support for Multiple Formats: Test the API's support for content negotiation by specifying different Accept headers (e.g., JSON, XML) and verifying that the response format matches the requested format.
- Resource Not Found Handling (404 Not Found): Confirm that the API consistently returns the appropriate "404 Not Found" response when attempting to access a non-existent resource.
- Response Time Measurement for Various Requests: Measure the API's response time for different types of requests to assess its performance and responsiveness.
- Handling Large Payloads (File Uploads): Verify that the API can handle large payloads, such as file uploads, without encountering errors or significant performance degradation.
- Compatibility with Client Libraries and SDKs: Evaluate the API's compatibility with different client libraries or SDKs to ensure seamless integration with various platforms and programming languages.
→ Check out the top automated functional testing tools on the current market
2. Test Cases For API Performance Testing
If the API developed in your team receives high traffic, it is a good idea to incorporate performance testing into your daily routine. In fact, performance testing should start even before development begins since it provides valuable insights into the maximum stress level of the server, which can help the IT Ops team better allocate and optimize resources usage. Here are some common test cases when doing performance testing of your APIs:
- Baseline Response Time: Measure the response time of a simple API request under normal conditions to establish a performance baseline.
- Stress Testing: Send a large number of simultaneous requests to the API to assess its performance under heavy load.
- Concurrency Testing: Evaluate how the API handles a specified number of concurrent requests without performance degradation.
- Ramp-up Testing: Gradually increase the number of requests over time to identify the API's breaking point and performance limits.
- Peak Load Testing: Test the API's performance at peak usage times to ensure it can handle maximum expected traffic.
- Endurance Testing: Continuously send requests to the API for an extended duration to assess its stability over time.
- Scalability Testing: Increase the load gradually and measure how the API scales by adding more resources (e.g., servers) to maintain performance.
- Resource Utilization Testing: Monitor CPU, memory, and network utilization while conducting performance tests to identify resource bottlenecks.
- Response Time Distribution: Analyze the distribution of response times to identify outliers and performance issues.
- Latency Testing: Measure network latency between the client and the API server to ensure low latency for users.
- Throughput Testing: Determine the maximum number of transactions the API can handle per unit of time while maintaining acceptable response times.
- Error Rate Testing: Monitor and record the rate of errors or failed requests during load testing to assess error handling and resilience.
- Caching Performance: Evaluate the impact of caching on response times and resource utilization.
- Data Volume Testing: Test the API with varying data volumes (e.g., small, medium, large payloads) to assess its performance with different data sizes.
- Geographical Load Testing: Simulate requests from different geographic locations to assess the API's global performance and response times.
- Concurrency with Authentication: Evaluate how the API handles concurrent requests with authentication, including token validation.
- Database Load Testing: Assess the impact of API requests on the associated database by measuring query response times.
- Long-Running Transactions: Test transactions that take a significant amount of time to complete and assess their impact on overall system performance.
- Rate Limiting Stress Testing: Test how the API handles excessive requests when rate limiting is in place.
- Failover Testing: Simulate server failures and test the API's ability to failover to backup servers while maintaining performance.
You May Also Like: Performance Testing vs Load Testing: A Complete Guide
3. Test Cases For API Security Testing
Finally, also make sure to check the security of your API, since this is the area where sensitive and high-value data is exchanged. APIs have always been a common target of attackers looking to gain unauthorized access to your systems. Some common API security test cases are:
- Authentication Testing: Verify that the API enforces proper authentication for all endpoints.
- Authorization Testing: Ensure that users can access only the resources they are authorized to access.
- Token Security: Test the security of authentication tokens, including token encryption and expiration.
- Session Management: Check for secure session management and handling of session cookies.
- SQL Injection: Test for SQL injection vulnerabilities by injecting malicious SQL queries in API parameters.
- Cross-Site Scripting (XSS): Verify that the API is protected against XSS attacks by injecting malicious scripts.
- Cross-Site Request Forgery (CSRF): Test if the API is vulnerable to CSRF attacks by submitting unauthorized requests.
- Input Validation: Ensure that the API validates and sanitizes user inputs to prevent injection attacks.
- Rate Limiting: Test the API's rate limiting to prevent abuse and DoS attacks.
- Sensitive Data Exposure: Verify that sensitive data, such as passwords or API keys, are not exposed in responses.
- HTTPS/TLS Testing: Ensure that the API uses secure communication via HTTPS/TLS and checks for certificate validity.
- CORS (Cross-Origin Resource Sharing) Security: Test for correct CORS headers to prevent unauthorized cross-origin requests.
- API Key Security: Assess the security of API keys and their storage.
- JWT (JSON Web Token) Security: Evaluate the security of JWTs used for authentication and authorization.
- Authentication Bypass: Attempt to bypass authentication mechanisms and gain unauthorized access.
- Session Fixation: Test if the API is vulnerable to session fixation attacks.
- Insecure Direct Object References (IDOR): Check for unauthorized access to resources by manipulating object references.
- Denial of Service (DoS) Testing: Attempt to overload the API and test its resilience against DoS attacks.
- API Versioning: Verify that the API supports versioning to prevent breaking changes from affecting existing clients.
- Security Headers: Check for the presence of security headers such as Content Security Policy (CSP), X-Content-Type-Options, etc., in API responses.
Read More: What is Penetration Testing? Definition, Practices, Tools
How To Write Test Cases For API Testing?
When writing a test case for API testing specifically,
- Understand the API thoroughly. Read through the API documentation from the API provider. Also check if an API sandbox is available for testing, and if there is, check its documentation too.
- Follow a consistent naming convention for test cases.
- You can group similar test cases together under a common feature/scenario
- Familiarize yourself with the requirement or feature you're testing before creating the test case so that you’ll know what information to include
- Use action verbs at the start of each test step like “Click”, “Enter” or “Validate”. If needed, you may even create a semantic structure to describe your test case. You can check out how it is done in BDD testing.
- Include any setup or prerequisites needed before executing the test.
- Ensure that the test cases you included are not only the “common” scenarios but also the negative scenarios that users don’t typically face but do happen in the system
- Use formatting to make your test cases easier to read and follow
- Make sure to update your test cases regularly
Write API Tests Faster & Better With Katalon Studio
Test Case Template For API Testing
To best write your test cases, you should always have a test case template, which we have prepared in PDF, Doc, and Excel sheet formats for you to download. Simply hit the button below and start noting down your test cases right away.
PDF | Doc | Excel
Or Simply Manage All of Your Test Cases With Katalon TestOps
Read More Test Case Samples:
How To Test APIs With Katalon - A Quality Management Platform
Katalon is a comprehensive AI-augmented software quality management platform, helping you to orchestrate the entire API testing lifecycle from test creation, execution, maintenance, to reporting.
For example, thanks to its Record-and-Playback features, you can easily capture test objects and record a sequence of activities, which can then be re-executed in regression testing sessions, saving tremendous time compared to manual testing.
Katalon Platform also supports running scripts on a wide range of devices, browsers, and testing environments, allowing QA teams to perform a lot of testing activities in just 1 place instead of having to spend time configuring environments and constantly switching tools.
After executing tests, Katalon Platform enables teams to review test results with the comprehensive and customizable test reports in LOG, HTML, CSV, and PDF formats before forwarding them as email attachments. There is a debugging mode for testers to conduct a root cause analysis for a specific failed case.
The platform integrates seamlessly into your CI/CD pipeline thanks to its diverse integration ecosystem. With its free forever version, Katalon Platform has nearly all of the features your team needs to start testing and bring value at no cost.
Here's a quick interactive demo to help you understand how Katalon API testing works:
Not just that, Katalon is also a forerunner in the AI testing space. You can leverage a lot of AI-powered features built into the platform to supercharge your testing.
Interested? Transform Your API Testing With Katalon For Free