AWS S3 Mock Server

S3-compatible mock server for dev and CI. Zero AWS setup.

Beeceptor’s S3 Community Mock Server is a fully S3-compatible, stateless mock endpoint designed for developers, testers, and CI environments. It supports all major S3 operations—such as bucket creation, object uploads/downloads, listing, deletions, multipart uploads, and policy management—using standard AWS SDKs in Node.js, Python, Java, and more. - No AWS account, credentials, or infrastructure setup is required. - The server accepts any dummy credentials and operates in a fixed `mock` region.- - Bucket-style endpoints are used and path-style addressing is supported via forcePathStyle. Example Resouce URL: https://s3-mock-bucket.mock.beeceptor.com/sample.txt Environment Variables: export AWS_ACCESS_KEY_ID=test-key export AWS_SECRET_ACCESS_KEY=test-secret export AWS_REGION=mock export AWS_S3_BUCKET=s3-mock-bucket

Use this hosted mock server to simulate AWS S3 APIs without authentication, API keys, or extra dependencies. Point your code or SDK to the Beeceptor base URL, preferably through an environment variable or feature flag, and switch back to the production API when ready. This keeps your integration code consistent across local development, QA, demos, and production.

Use cases:

Integration testing, CI pipeline validation, contract testing, prototyping, and running demos or training sessions, without incurring AWS costs or risking real data. The server can return dynamic, realistic XML responses but does not persist data across requests. This is ideal for teams building S3-integrated applications who want fast, isolated, and low-friction testing environments.

AWS S3 mock server is up and running!

Use this mock URL as the API base in your code to simulate AWS S3 responses instantly.

`https://s3-mock-bucket.mock.mock-api.online`

GET?x-id=ListBuckets

List Buckets – Retrieves a list of all available S3 buckets.

200

Request Headers:

N/A

Request Body:

N/A

Response Headers:

{
  "Content-Type": "application/xml"
}

Response Body:

<?xml version="1.0" encoding="UTF-8"?>
<ListAllMyBucketsResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
  <Owner>
    <ID>{{faker 'string.uuid'}}</ID>
    <DisplayName>{{faker 'internet.userName'}}</DisplayName>
  </Owner>
  <Buckets>
    <Bucket>
      <Name>{{faker 'word.noun'}}</Name>
      <CreationDate>2025-05-01T12:00:00.000Z</CreationDate>
    </Bucket>
    <Bucket>
      <Name>{{faker 'word.noun'}}</Name>
      <CreationDate>2025-05-01T12:00:00.000Z</CreationDate>
    </Bucket>
    <Bucket>
      <Name>{{faker 'word.noun'}}</Name>
      <CreationDate>2025-05-01T12:00:00.000Z</CreationDate>
    </Bucket>
  </Buckets>
</ListAllMyBucketsResult>

PUT?x-id=CreateBucket

Create Bucket (PutBucket) – Creates a new S3 bucket.

200

Request Headers:

N/A

Request Body:

N/A

Response Headers:

{
  "Content-Type": "application/xml"
}

Response Body:

N/A

DELETE?x-id=DeleteBucket

Delete Bucket – Deletes an existing S3 bucket.

204

Request Headers:

N/A

Request Body:

N/A

Response Headers:

{
  "Content-Type": "application/xml"
}

Response Body:

N/A

GET?x-id=GetObject

Get Object – Retrieves a specific object from a bucket.

200

Request Headers:

N/A

Request Body:

N/A

Response Headers:

{
  "Content-Type": "application/xml"
}

Response Body:

<Person>
  <Id>60d6d055-7cfc-42c9-911f-50c170a7d618</Id>
  <Name>Edwin Jenkins</Name>
  <Email>Selina_Tillman@yahoo.com</Email>
  <Phone>862-903-6677 x24342</Phone>
</Person>

GET.*([?&]x-id=ListObjects(V2)?|[?&]list-type=2).*

List Objects – Lists objects inside a specified S3 bucket.

200

Request Headers:

N/A

Request Body:

N/A

Response Headers:

{
  "Content-Type": "application/xml"
}

Response Body:

<ListBucketResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
  <Name>bucket</Name>
  <Prefix/>
  <KeyCount>{{faker 'number.int' '10'}}</KeyCount>
  <MaxKeys>1000</MaxKeys>
  <IsTruncated>false</IsTruncated>

  {{#repeat 10}}
  <Contents>
    <Key>{{faker 'system.fileName' ext='jpg'}}</Key>
         <LastModified>2025-05-01T12:00:00.000Z</LastModified>
    <ETag>"{{faker 'string.hexadecimal' length=32 casing='lower' prefix=''}}"</ETag>
    <Size>{{faker 'number.int' min=10000 max=5000000}}</Size>
    <StorageClass>STANDARD</StorageClass>
    <Owner>
      <ID>{{faker 'string.hexadecimal' length=24 casing='lower' prefix=''}}{{faker 'string.hexadecimal' length=8 casing='lower' prefix=''}}</ID>
      <DisplayName>{{faker 'internet.email'}}</DisplayName>
    </Owner>
  </Contents>
  {{/repeat}}

</ListBucketResult>

PUT?x-id=PutObject

Put Object – Uploads or updates an object in a bucket.

200

Request Headers:

N/A

Request Body:

N/A

Response Headers:

{
  "Content-Type": "application/xml"
}

Response Body:

N/A

PUT?x-id=CopyObject

Copy Object – Copies an object from one bucket/location to another.

200

Request Headers:

N/A

Request Body:

N/A

Response Headers:

{
  "Content-Type": "application/xml"
}

Response Body:

<CopyObjectResult>
  <ETag>"d41d8cd98f00b204e9800998ecf8427e"</ETag>
  <LastModified>2021-01-01T12:00:00.000Z</LastModified>
</CopyObjectResult>

DELETE?x-id=DeleteObject

Delete Object – Removes a specific object from an S3 bucket.

204

Request Headers:

N/A

Request Body:

N/A

Response Headers:

{
  "x-amz-request-id": "32FE2CEB32F5EE25",
  "Content-Type": "image/png"
}

Response Body:

N/A

PUT?acl=

Configure ACL for a S3 Bucket.

200

Request Headers:

N/A

Request Body:

N/A

Response Headers:

{
  "Content-Type": "application/xml"
}

Response Body:

N/A

GET?acl=

Get ACL(Access Control List) of Bucket

200

Request Headers:

N/A

Request Body:

N/A

Response Headers:

{
  "Content-Type": "application/xml"
}

Response Body:

<AccessControlPolicy xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
  <Owner>
    <ID>owner-canonical-user-id</ID>
    <DisplayName>owner-display-name</DisplayName>
  </Owner>
  <AccessControlList>
    <Grant>
      <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="CanonicalUser">
        <ID>owner-canonical-user-id</ID>
        <DisplayName>owner-display-name</DisplayName>
      </Grantee>
      <Permission>FULL_CONTROL</Permission>
    </Grant>
    <Grant>
      <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="Group">
        <URI>http://acs.amazonaws.com/groups/global/AllUsers</URI>
      </Grantee>
      <Permission>READ</Permission>
    </Grant>
  </AccessControlList>
</AccessControlPolicy>

GET?location

Get Location of s3 Bucket.

200

Request Headers:

N/A

Request Body:

N/A

Response Headers:

{
  "Content-Type": "application/xml"
}

Response Body:

<LocationConstraint xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
  us-west-2
</LocationConstraint>

POST?uploads=

Initiate Multipart Upload

200

Request Headers:

N/A

Request Body:

N/A

Response Headers:

{
  "Content-Type": "application/xml"
}

Response Body:

<InitiateMultipartUploadResult>
  <Bucket>atharva</Bucket>
  <Key>package.json</Key>
  <UploadId>example-upload-id</UploadId>
</InitiateMultipartUploadResult>

PUT/?partNumber=\d+&uploadId=[^&]+&x-id=UploadPart$

Partial Multpiart Upload

200

Request Headers:

N/A

Request Body:

N/A

Response Headers:

{
  "Content-Type": "application/json"
}

Response Body:

{
  "status": "Success!"
}

PUT?object-lock=

Enable Object Lock

200

Request Headers:

N/A

Request Body:

N/A

Response Headers:

{
  "Content-Type": "application/xml"
}

Response Body:

N/A

POST?uploadId=

Complete Multipart Upload

200

Request Headers:

N/A

Request Body:

N/A

Response Headers:

{
  "Content-Type": "application/xml"
}

Response Body:

<?xml version="1.0" encoding="UTF-8"?>
<CompleteMultipartUploadResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
    <Location>https://bucket.amazonaws.com/beeceptor.txt</Location>
    <Bucket>Beeceptor</Bucket>
    <Key>/beeceptor.txt</Key>
    <ETag>"abc123def456-1"</ETag>
</CompleteMultipartUploadResult>

PUT?cors=

Set up CORS for S3 Bucket.

200

Request Headers:

N/A

Request Body:

N/A

Response Headers:

{
  "Content-Type": "application/xml"
}

Response Body:

N/A

Service Homepage: aws.amazon.com/s3/

API documentation: beeceptor.com/docs/tutorials/aws-s3-mock-server/

blobstorages3-awssimple storage service