308

Permanent Redirect

3xx Redirection The resource is now permanently located at another URI

Code Examples

Here are examples of how to test HTTP 308 responses in different programming languages:

Select options below to see how to use advanced features in your code:

Request:
curl https://free.mockerapi.com/308
Response Body:
{
  "success": true,
  "status": 308,
  "statusText": "Permanent Redirect - The resource is now permanently located at another URI",
  "timestamp": "2025-10-08T10:30:45.123Z",
  "request": {
    "method": "GET",
    "url": "/308",
    "fullUrl": "https://free.mockerapi.com/308"
  }
}
Request:
fetch('https://free.mockerapi.com/308')
  .then(response => {
    console.log('Status:', response.status); // 308
    return response.json();
  })
  .then(data => {
    console.log('Success:', data);
  })
  .catch(error => {
    console.error('Error:', error);
  });
Response Body:
{
  "success": true,
  "status": 308,
  "statusText": "Permanent Redirect - The resource is now permanently located at another URI",
  "timestamp": "2025-10-08T10:30:45.123Z",
  "request": {
    "method": "GET",
    "url": "/308",
    "fullUrl": "https://free.mockerapi.com/308"
  }
}
Request:
import requests

response = requests.get('https://free.mockerapi.com/308')

print(f'Status Code: {response.status_code}')  # 308
print(f'Response: {response.json()}')
Response Body:
{
  "success": true,
  "status": 308,
  "statusText": "Permanent Redirect - The resource is now permanently located at another URI",
  "timestamp": "2025-10-08T10:30:45.123Z",
  "request": {
    "method": "GET",
    "url": "/308",
    "fullUrl": "https://free.mockerapi.com/308"
  }
}
Request:
Response Body:
{
  "success": true,
  "status": 308,
  "statusText": "Permanent Redirect - The resource is now permanently located at another URI",
  "timestamp": "2025-10-08T10:30:45.123Z",
  "request": {
    "method": "GET",
    "url": "/308",
    "fullUrl": "https://free.mockerapi.com/308"
  }
}
Request:
require 'net/http'
require 'json'

uri = URI('https://free.mockerapi.com/308')
response = Net::HTTP.get_response(uri)

puts "Status Code: #{response.code}"  # 308
puts "Response: #{JSON.parse(response.body)}"
Response Body:
{
  "success": true,
  "status": 308,
  "statusText": "Permanent Redirect - The resource is now permanently located at another URI",
  "timestamp": "2025-10-08T10:30:45.123Z",
  "request": {
    "method": "GET",
    "url": "/308",
    "fullUrl": "https://free.mockerapi.com/308"
  }
}
Request:
package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    resp, err := http.Get("https://free.mockerapi.com/308")
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    fmt.Printf("Status Code: %d\n", resp.StatusCode)  // 308

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Printf("Response: %s\n", body)
}
Response Body:
{
  "success": true,
  "status": 308,
  "statusText": "Permanent Redirect - The resource is now permanently located at another URI",
  "timestamp": "2025-10-08T10:30:45.123Z",
  "request": {
    "method": "GET",
    "url": "/308",
    "fullUrl": "https://free.mockerapi.com/308"
  }
}
Request:
import java.net.http.*;
import java.net.URI;

public class HttpStatusTest {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://free.mockerapi.com/308"))
            .GET()
            .build();

        HttpResponse response = client.send(request,
            HttpResponse.BodyHandlers.ofString());

        System.out.println("Status Code: " + response.statusCode());  // 308
        System.out.println("Response: " + response.body());
    }
}
Response Body:
{
  "success": true,
  "status": 308,
  "statusText": "Permanent Redirect - The resource is now permanently located at another URI",
  "timestamp": "2025-10-08T10:30:45.123Z",
  "request": {
    "method": "GET",
    "url": "/308",
    "fullUrl": "https://free.mockerapi.com/308"
  }
}
Request:
const https = require('https');

https.get('https://free.mockerapi.com/308', (res) => {
  console.log('Status Code:', res.statusCode);  // 308

  let data = '';

  res.on('data', (chunk) => {
    data += chunk;
  });

  res.on('end', () => {
    console.log('Response:', JSON.parse(data));
  });
}).on('error', (err) => {
  console.error('Error:', err.message);
});
Response Body:
{
  "success": true,
  "status": 308,
  "statusText": "Permanent Redirect - The resource is now permanently located at another URI",
  "timestamp": "2025-10-08T10:30:45.123Z",
  "request": {
    "method": "GET",
    "url": "/308",
    "fullUrl": "https://free.mockerapi.com/308"
  }
}

What is HTTP 308 Permanent Redirect?

HTTP 308 Permanent Redirect indicates that the request has more than one possible response. The server is informing the client that there are multiple options available for the requested resource, and the user or user agent should choose one of them.

This status code is rarely used in practice. When implemented, the server should include a list of resource characteristics and locations from which the user or user agent can choose the most appropriate one.

When Does This Happen?

A 308 Permanent Redirect response is returned when:

  • A resource is available in multiple formats (e.g., different languages, file formats)
  • Multiple versions of a resource exist and the server wants the client to choose
  • The server cannot determine which representation to return based on the request headers
  • Content negotiation requires explicit user selection

Try It Live

Click the button below to make a live request and see the 308 Permanent Redirect response

Common Use Cases

๐ŸŒ Content Negotiation Testing

Test how your application handles multiple resource options and content negotiation scenarios.

๐Ÿ”„ Multi-Format Resources

Mock responses for resources available in multiple formats (JSON, XML, etc.) or languages.

๐Ÿ“‹ Version Selection

Test client behavior when multiple versions of an API or resource are available.

๐ŸŽฏ Client Choice Testing

Verify that your application properly handles scenarios where user selection is required.

๐Ÿ” API Documentation

Demonstrate multiple choice scenarios in API documentation with working examples.

๐Ÿงช Edge Case Testing

Test rarely-used HTTP status codes to ensure comprehensive error handling.

Related Redirection Status Codes