This is an example of how to use Mockend to quickly setup a mock REST API for development and testing.

This is an example of how to use Mockend to quickly setup a mock REST API for development and testing.

Today I was goofing around with some development tools and I needed a simple REST API to do a little bit of testing. I really enjoy working with tools that make my life easier and I’ve written about tools like this before.

This time around we are going to look at how to use Mockend to quickly setup a REST API. Note this is a paid service but there is a free version for personal use.

To get started, go to and click on “Setup a plan”.

Mockend rest API Setup Step 1
Mockend Setup Step 1

Select the free plan and click on Install it for free! If you are already signed into your Github Account it will automatically use that or it will ask you to login to GitHub.

Mockend reset API Setup Step 2
Mockend Setup Step 2

Next you click on “Complete order and begin installation” and then two last steps “Install & Authorize” and enter your TFA code and you are in business.

Mockend Setup Example Step 3
Mockend Setup Step 3

Now in your project repo create a .mockend.json file with the following basic config on your repo:

In my example that would be something like: 

      "User": {
        "title": { "string": {} }

Try your new mock server:

1. List your fake users with a GET request


In my example that is:


2. Fake a creation with POST

(don’t worry changes aren’t persisted)
    curl<YourName>/<YourRepoName>/users \
      -X POST \
      -H "Content-Type: application/json" \
      --data '{"name": "alice"}'

3. Access your GraphQL endpoint

Test other random generators with this config:

  "User": {
    "name": {
      "string": {}
    "avatarUrl": {
      "regexp": "https://i\\.pravatar\\.cc/150\\?u=[0-9]{5}"
    "statusMessage": {
      "string": [
        "working from home",
        "watching Netflix"
    "email": {
      "regexp": "#[a-z]{5,10}@[a-z]{5}\\.[a-z]{2,3}"
    "color": {
      "regexp": "#[0-9A-F]{6}"
    "age": {
      "int": {
        "min": 21,
        "max": 100
    "isPublic": {
      "boolean": {}

Or, See their documentation for more details at

And that seemed so easy but, when I tested it, it didn’t work. I got some error that I needed to switch to the paid plan or select 1 repo. Nowhere did I find any information on how to “select that 1 repo”. But this is what I found.

  1. Go back to
  2. Click on “Configure access”.
Mockend Setup Step 4
Mockend Setup Step 4

3. Click the “Configure” button.

Mockend Setup Step 5
Mockend Setup Step 5

4. On the next page click the radio button next to “Only Selected Repos” and,

5. Select the Repo that you pushed the .mockend.json file to.

Mockend Setup Step 6
Mockend Setup Step 6

And now you ARE in business!

Mockend Setup Step 7 - Success!
Mockend Setup Step 7 – Success!

Have fun with @Mockend

Leave a Reply

Your email address will not be published.

Related Posts
Continuous Learning with AWS

Five Steps to Get AWS Certified

Five Steps to Get AWS Certified. Propel your career! Take your career to the next level with AWS Certifications. AWS Certifications are a great way to validate your technical skills and build your expertise.