---
title: Using Postman to call FraudLabs Pro Order Screen API
description: "## Intro Postman is a development tool you can use to test the calling of an API. We will demonstrate how to configure Postman with the FraudLabs Pro Fraud Detection API Swagger configuration to easily setup the request to the…"
url: "https://www.fraudlabspro.com/resources/tutorials/using-postman-to-call-fraudlabs-pro-order-screen-api/"
updated: "2026-08-06"
category: Developer Guide
---

# Using Postman to call FraudLabs Pro Order Screen API

## Intro

Postman is a development tool you can use to test the calling of an API. We will demonstrate how to configure Postman with the FraudLabs Pro Fraud Detection API Swagger configuration to easily setup the request to the API.

## Pre-requisites

First of all, you will need to download the Postman software and install it. Next, you’ll need to go to the FraudLabs Pro Fraud Detection API Swagger page at  [https://app.swaggerhub.com/apis/fraudlabspro/fraudlabspro-fraud-detection/1.1](https://app.swaggerhub.com/apis/fraudlabspro/fraudlabspro-fraud-detection/1.1) where you need to copy out the whole YAML configuration text. The YAML text is the part inside the red box below.

[![FraudLabs Pro Fraud Detection API Swagger page](https://www.fraudlabspro.com/resources/wp-content/uploads/2019/04/swagger_yaml.jpg)](https://www.fraudlabspro.com/resources/wp-content/uploads/2019/04/swagger_yaml.jpg)

## Configuring Postman with the YAML text

Run the Postman software and you should see the below. If you get shown the Create New dialog, you can just close it.

[![Postman software](https://www.fraudlabspro.com/resources/wp-content/uploads/2019/04/postman.jpg)](https://www.fraudlabspro.com/resources/wp-content/uploads/2019/04/postman.jpg)

Click on the Import button at the top left and you should see the below. Click on Paste Raw Text in the Import dialog. Next, paste the YAML text from above then click on Import.

[![Import and paste raw text to the dialog box](https://www.fraudlabspro.com/resources/wp-content/uploads/2019/04/paste_yaml.jpg)](https://www.fraudlabspro.com/resources/wp-content/uploads/2019/04/paste_yaml.jpg)

You should now see the following. Click on the part inside the red box. That will expand the collection to show you all available APIs.

[![FraudLabs Pro Fraud Detection API](https://www.fraudlabspro.com/resources/wp-content/uploads/2019/04/imported.jpg)](https://www.fraudlabspro.com/resources/wp-content/uploads/2019/04/imported.jpg)

## First test of calling the API

Click on the first API which is the order screen API. You will then see the parameters required to perform a POST request to this API. You can go ahead and delete the 2^nd API as we won't be using it.

[![Perform a POST request to FraudLabs Pro Fraud Detection API](https://www.fraudlabspro.com/resources/wp-content/uploads/2019/04/api_params.jpg)](https://www.fraudlabspro.com/resources/wp-content/uploads/2019/04/api_params.jpg)

You can just replace the values in the VALUE column of the Params section with actual values that you wish to pass to the API. Let's test this API with the following values:

| **Parameter name** | **Parameter value** |
| --- | --- |
| ip | 8.8.8.8 |
| key | *Your own Fraudlabs Pro API key* |
| format | json |
| last_name | Smith |
| first_name | Jason |
| bill_addr | 1766 PowderHouse Road |
| bill_city | West Palm Beach |
| bill_state | FL |
| bill_country | US |
| bill_zip_code | 33401 |
| amount | 99.95 |
| quantity | 1 |
| currency | USD |

If you don't have an API key, you can sign up for a free API key via the Micro plan at  [https://www.fraudlabspro.com/pricing](https://www.fraudlabspro.com/pricing) and you can input it like below. You can uncheck the fields that we are not providing any values.

[![Uncheck the fields which have no value](https://www.fraudlabspro.com/resources/wp-content/uploads/2019/04/input_params.jpg)](https://www.fraudlabspro.com/resources/wp-content/uploads/2019/04/input_params.jpg)

Upon pressing the Send button, you will receive the json result as below.

[![Fraud validation result in JSON format](https://www.fraudlabspro.com/resources/wp-content/uploads/2019/04/json_result.jpg)](https://www.fraudlabspro.com/resources/wp-content/uploads/2019/04/json_result.jpg)

## Calling the API using a bulk input file

The previous section dealt with calling the API with a manually keyed in set of inputs. What if you have a file full of inputs you want to pass to the API? We will now show how to read inputs from a file to pass to the API.

For our example, we have a file called flptest.csv which looks like below. The CSV data file should have a header.

[![Fraud validation result in XLS format](https://www.fraudlabspro.com/resources/wp-content/uploads/2019/04/csv_data.jpg)](https://www.fraudlabspro.com/resources/wp-content/uploads/2019/04/csv_data.jpg)

Before we run the bulk input file through the API, we need to create some tests to validate the results being returned from the API. Click on the Tests section and paste the following codes. The codes will test the return values of the 3 rows of input we have in our test file.

pm.test("Country Test", function() {

var jsonData = pm.response.json();

pm.expect(jsonData.is_country_match).to.eql("Y");

});

[![Testing the codes](https://www.fraudlabspro.com/resources/wp-content/uploads/2019/04/create_test.jpg)](https://www.fraudlabspro.com/resources/wp-content/uploads/2019/04/create_test.jpg)

To have the API work with dynamic values from the test file, we have to modify the following parameters to become variables. The variable names must follow the header names in the CSV file. The fields that we manually supplied values should now be using variables with the header names, i.e. {{ip}} and {{amount}}. This means the dynamic values for these fields will come from their named counterpart in the CSV file. The curly braces are required to denote that these values are variables.

[![Modify the following parameters to become variables](https://www.fraudlabspro.com/resources/wp-content/uploads/2019/04/variable_params.jpg)](https://www.fraudlabspro.com/resources/wp-content/uploads/2019/04/variable_params.jpg)

Now we are ready to call the API using input from the bulk input file. Inside Postman, click on the Runner button at the top left of the program. The button is enclosed in the red box inside the above image.

The Collection Runner window should now be shown. Click on the FraudLabs Pro Fraud Detection collection. Click inside until you reach the order screen API. Next, click Select File to select the flptest.csv file from above. Then click on the blue Run button.

[![Run order](https://www.fraudlabspro.com/resources/wp-content/uploads/2019/04/collection_runner.jpg)](https://www.fraudlabspro.com/resources/wp-content/uploads/2019/04/collection_runner.jpg)

The test results are done and looks like all 3 input lines have passed the validation test.

[![Test results passed the validation test](https://www.fraudlabspro.com/resources/wp-content/uploads/2019/04/validation_results.jpg)](https://www.fraudlabspro.com/resources/wp-content/uploads/2019/04/validation_results.jpg)

## Ready to start with FraudLabs Pro?

Get Micro plan for free, you can quickly explore and integrate with our fraud prevention solution in minutes.

[Sign Up Free](https://www.fraudlabspro.com/checkout-micro#fraudlabspro-freesignup)