# Seller item listing

**POST**

Send information about a seller's new inventory in order to receive a fraud or abuse decision.

## Credentials

**HTTP Basic** `basicAuth`

## Path Parameters

- `id`: string *

## Header Parameters

- `api-version`: string *
- `x-forter-siteid`: string *

## Body Parameters

- `body`: `accountItemListingRequest` *

### Description

Send information about a seller's new inventory in order to receive a fraud or abuse decision.

- **accountData**: object  
  All Of  
  - **AccountData**  
  - `accountId`: string *  
  - **additionalInformation**: object  
    All Of  
    - **GeneralPayloadMap**  
    - `channelType`: string  
      `<WEB | PHONE | DYNAMIC_PHONE | MOBILE | MOBILE_IN_STORE | IOS | ANDROID | WAP | STORE | MERCHANT_EMPLOYEE | MAIL_ORDER | AUTOMATIC_RENEWAL_OR_INSTALLMENT_PAYMENT | MERCHANT_INITIATED | UNKNOWN | POS | API_ONLY | PERSONAL_POS | PHONE_LINK>` nullable  
    - **connectionInformation**: `ConnectionInformation` *  
    - `eventTime`: number *  
    - `listedItems`: `Item[]` *  
    - **merchantIdentifiers**: object  
      All Of  
      - **MerchantIdentifiers** +

### Responses

**200**

**Example adaptiveAuthAccountsResponse**  
{
  "accountId": "e520-ba9a-367-60b",
  "correlationId": "HGJ7512345H3DE",
  "decisionReason": "",
  "forterDecision": "",
  "merchantPolicyId": "0ee8ba28a8654c659addbae9253b707c",
  "recommendation": "",
  "verificationMethod": {
    "correlationId": "HGJ7512345H3DE",
    "status": "FRICTIONLESS",
    "statusCode": "100",
    "statusMessage": "Verification code sent",
    "type": "THREE_DS",
    "verificationId": "345H3DEHGJ7512",
    "verificationSpecificData": {
      "ThreeDS": {},
      "email": {},
      "phone": {}
    }
  }
}

**400** Bad Request (Often missing a required parameter)

**401** Unauthorized (No valid API key provided)

**404** Not Found (The requested item doesn't exist)

**500** Server Error (Something went wrong on Forter's end)

## Request

**Curl**

```bash
curl --request POST \ 
  --url https://api.forter-secure.com/v2/accounts/item-listing/{id} \ 
  --header 'accept: application/json' \ 
  --header 'content-type: application/json' \ 
  --header 'api-version: 10.1' \ 
  --header 'x-forter-siteid: a1b2c3d4e5f6' \ 
  --data-raw '{
    "accountData": {
      "additionalVerificationDocuments": {
        "documentSource": "UPLOADED_FILE",
        "documentType": "Passport",
        "documentVerificationServiceResponsePayload": {}
      },
      "addressesInAccount": [
        {
          "address1": "235 Montgomery st.",
          "city": "San Francisco",
          "country": "US",
          "savedData": {
            "usedSavedData": true
          }
        }
      ],
      "customerEngagement": {
        "communityPostsWritten": {
          "updateTimes": {
            "creationTime": 1448549922
          }
        },
        "invites": [
          {"type": "SENT"}
        ],
        "likedItems": {
          "updateTimes": {
            "creationTime": 1448549922
          }
        },
        "messagesReceived": {
          "updateTimes": {
            "creationTime": 1448549922
          }
        },
        "messagesSent": {
          "updateTimes": {
            "creationTime": 1448549922
          }
        },
        "newsletters": {
          "updateTimes": {
            "creationTime": 1448549922
          }
        },
        "reviewsWritten": {
          "updateTimes": {
            "creationTime": 1448549922
          }
        },
        "savedLocations": [{
          "latitude": 32.07332,
          "longitude": 34.79675,
          "source": "MOBILE"
        }],
        "sharedItems": {
          "updateTimes": {
            "creationTime": 1448549922
          }
        },
        "wishlist": {
          "updateTimes": {
            "creationTime": 1448549922
          }
        }
      },
      "emailsInAccount": [
        {
          "email": "john_s@test.com",
          "emailVerification": {
            "sent": true,
            "verified": false
          }
        }
      ],
      "phonesInAccount": [
        {
          "phone": "15557654321",
          "smsVerified": {
            "sent": true,
            "verified": false
          }
        }
      ],
      "ratingAsBuyer": {
        "score": "4.5",
        "source": "yelp",
        "type": "INTERNAL_PEERS"
      }
    },
    "accountId": "e520-ba9a-367-60b",
    "additionalInformation": {},
    "connectionInformation": {
      "customerIP": "10.0.0.127",
      "userAgent": "Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/47.0.2526.73 Safari/537.36"
    },
    "eventTime": 1415287568000,
    "listedItems": [
      {
        "basicItemData": {
          "discount": {
            "couponCodeUsed": "FATHERSDAY2015",
            "couponDiscountAmount": {}
          },
          "name": "White GenericBrand handbag",
          "price": {},
          "quantity": 1,
          "type": "TANGIBLE"
        },
        "beneficiaries": [
          {
            "additionalVerificationDocuments": {
              "documentSource": "UPLOADED_FILE",
              "documentType": "Passport",
              "documentVerificationServiceResponsePayload": {}
            },
            "address": {
              "address1": "235 Montgomery st.",
              "city": "San Francisco",
              "country": "US",
              "savedData": {
                "usedSavedData": true
              }
            },
            "bankAccount": {
              "paymentGatewayData": {}
            },
            "comments": {},
            "cryptoWallet": {
              "cryptoWalletType": "EXTERNAL"
            },
            "personalDetails": {},
            "phone": [{
              "phone": "15557654321",
              "smsVerified": {
                "sent": true,
                "verified": false
              }
            }]
          }
        ],
        "deliveryDetails": {
          "deliveryMethod": "USPS - Ground Mail",
          "deliveryPrice": {},
          "deliveryType": "PHYSICAL"
        },
        "itemReturnData": {
          "posDetails": {
            "address": {
              "address1": "235 Montgomery st.",
              "city": "San Francisco",
              "country": "US",
              "savedData": {
                "usedSavedData": true
              }
            },
            "cardEntryMethod": "SCANNED",
            "cashierId": "fgh5e0rr48923d",
            "departmentId": "e0r4592356fds",
            "storeBusinessUnit": "Full Line",
            "storeId": "2356fdse0rr489",
            "storeName": "Union Square",
            "workStationId": "923e5th5e0rr48"
          },
          "returnStatusLog": {}
        },
        "itemSpecificData": {
          "accommodation": {
            "accommodationAddress": {
              "address1": "235 Montgomery st.",
              "city": "San Francisco",
              "country": "US",
              "savedData": {
                "usedSavedData": true
              }
            },
            "duration": {
              "endDate": "2014-11-15",
              "startDate": "2014-10-28"
            },
            "location": {},
            "numberOfGuests": 2,
            "rating": [{
              "score": "4.5",
              "source": "yelp",
              "type": "INTERNAL_PEERS"
            }],
            "type": "HOTEL"
          },
          "cryptocurrency": {},
          "digitalGoodsAndServices": {
            "duration": {
              "endDate": "2014-11-15",
              "startDate": "2014-10-28"
            },
            "webHosting": {
              "domains": []
            }
          },
          "food": {
            "restaurantAddress": {
              "address1": "235 Montgomery st.",
              "city": "San Francisco",
              "country": "US",
              "savedData": {
                "usedSavedData": true
              }
            },
            "tipAmount": {}
          },
          "gaming": {
            "gameItemAmount": 1000,
            "gameName": "WorldOfSampleGamecrat"
          },
          "physicalGoods": {},
          "professionalServices": {
            "tipAmount": {}
          },
          "ticketsAndEvents": {
            "eventLocation": {
              "address1": "235 Montgomery st.",
              "city": "San Francisco",
              "country": "US",
              "savedData": {
                "usedSavedData": true
              }
            },
            "eventName": "FIFA World Cup Final"
          },
          "transport": [{
            "driverDetails": {
              "availableFundsForWithdrawal": {},
              "ratingAsBuyer": {
                "score": "4.5",
                "source": "yelp",
                "type": "INTERNAL_PEERS"
              },
              "ratingAsSeller": {
                "score": "4.5",
                "source": "yelp",
                "type": "INTERNAL_PEERS"
              },
              "sellerAccountCreationDate": 1415273168,
              "sellerLastLoginIP": {
                "ip": "10.0.0.128",
                "updateTimes": {}
              },
              "sellerPersonalDetails": {},
              "sellerRegistrationIP": {
                "ip": "10.0.0.128",
                "updateTimes": {}
              }
            },
            "duration": {
              "startTime": 1412345911
            },
            "endPoint": {
              "address": {
                "address1": "235 Montgomery st.",
                "city": "San Francisco",
                "country": "US",
                "savedData": {}
              },
              "exactLocation": {
                "latitude": 32.07332,
                "longitude": 34.79675,
                "source": "MOBILE"
              },
              "locationName": {},
              "roughLocation": {},
              "savedLocation": {
                "usedSavedData": true
              }
            },
            "locationAtTimeOfReservation": {
              "address": {
                "address1": "235 Montgomery st.",
                "city": "San Francisco",
                "country": "US",
                "savedData": {}
              },
              "exactLocation": {
                "latitude": 32.07332,
                "longitude": 34.79675,
                "source": "MOBILE"
              },
              "locationName": {},
              "roughLocation": {},
              "savedLocation": {
                "usedSavedData": true
              }
            },
            "startPoint": {
              "address": {
                "address1": "235 Montgomery st.",
                "city": "San Francisco",
                "country": "US",
                "savedData": {}
              },
              "exactLocation": {
                "latitude": 32.07332,
                "longitude": 34.79675,
                "source": "MOBILE"
              },
              "locationName": {},
              "roughLocation": {},
              "savedLocation": {
                "usedSavedData": true
              }
            },
            "type": "AIR_TRAVEL"
          }]
        },
        "seller": {
          "sellerDetails": {
            "availableFundsForWithdrawal": {},
            "ratingAsBuyer": {
              "score": "4.5",
              "source": "yelp",
              "type": "INTERNAL_PEERS"
            },
            "ratingAsSeller": {
              "score": "4.5",
              "source": "yelp",
              "type": "INTERNAL_PEERS"
            },
            "sellerAccountCreationDate": 1415273168,
            "sellerLastLoginIP": {
              "ip": "10.0.0.128",
              "updateTimes": {"creationTime": 1448549922}
            },
            "sellerPersonalDetails": {},
            "sellerRegistrationIP": {
              "ip": "10.0.0.128",
              "updateTimes": {"creationTime": 1448549922}
            }
          }
        },
        "shopifyAdditionalItemData": {
          "properties": {}
        }
      }
    ],
    "merchantIdentifiers": {}
}'
```