GunBroker.com REST API
DevKey: darkkermit    

/Seller POST

Submits User information for Becoming a Seller on GunBroker.com.

URL
/Seller
Verb
POST

Headers

Header Data Type Valid Values Required Description
Content-Type string application/json YES The format your data will be sent to our site.
X-DevKey string string YES The devkey assigned to the developer.
X-AccessToken string string Optional The token acquired from a POST to Users/AccessToken.

Input

NOTE: Variables to place in the body of the request.

This API call is different than most of the other API calls in our system. Most requests in our API are single part requests where the Content-Type header describes the single type of content in the body of the request (ie. text/json). This request however is a multipart request which allows you to upload your business license at the same time in the same HTTP requst. The Content-Type header of this request must be set to multipart/form-data.

The individual parts of this request must contain a single part with the data holding the JSON for the user, and the businessregistrationlicense part for holding the information of the file. For the data part, the Content-Disposition must be set to form-data; name="data". The business registration license part must have a Content-Disposition of form-data; name="businessregistrationlicense"; filename="yourfilename.jpg" and cannot exceed 75 characters in length.


Parameter Data Type Valid Values Description
IsBusiness boolean true If set to true, the application will evaluate the Business Information instead of the Individual Information.
ToSAgreement boolean true Terms and Service Agreement. Required for becoming a seller.
BecomeASellerAgreement boolean true Seller Agreement. Required for becoming a seller.
SellerIndividualInfo object
FirstName - string
MiddleName - string
LastName - string
DatOfBirth - string
Address - Object
EmailAddress - string
Phone - string
SSN - string
ConfirmSSN - string
OwnershipPerc - double
IsPrimaryOwner - boolean
IdDocument - object
State must be a 2 character code, Format: XX
Country must be a 2 character code, Format: XX
SSN(Social Security Number) format: XXX-XX-XXXX
OwnershipPerc & IsPrimaryOwner are not required for Individual Sellers
PO Box cannot be used in Address1 or Address2

Address Object:
Address : {
    "Address1":"string",
    "Address2":"string",
    "City":"string",
    "State":"string",
    "PostalCode":"string",
    "Country":"string"
}

IdDocument Object:
IdDocument : {
    "Type":"int",
    "Number":"string",
    "Expiry":"DateTime",
    "IssuingState":"string",
    "Country":"string"
    }
IdDocument Type options: DriversLicense = 1, Passport = 2, StateId = 3
SellerBusinessInfo object
RegisteredBusinessName - string
PublicBusinessName - string
Address - Address Object
CommAddress - Address Object
IncorporatedDate - string
BusinessEmailAddress - string
BusinessPrimaryPhone - string
BusinessSecondaryPhone - string
EIN - string
ConfirmEIN - string
LicenseExpDate - string
Type - int
Owners - Array<SellerIndividualInfo>
State must be a 2 character code, Format: XX
Country must be a 2 character code, Format: XX
IncorporatedDate format: XX/XX/XX
EIN(Employer Identification Number) format: XX-XXXXXXX
LicenseExpDate format: XX/XX/XX
Type options: SoleProprietor = 0(default), Corporation = 1, LimitedLiabilityCompany = 2, Partnership = 3, PublicCorporation = 4, NonProfitOrganization = 5, GovernmentOrganization = 6
PO Box cannot be used in Address1 or Address2

Address Object:
Address : {
    "Address1":"string",
    "Address2":"string",
    "City":"string",
    "State":"string",
    "PostalCode":"string",
    "Country":"string"
}
BankAccountInfo object
BankName - string
NickName - string
AccountOwner - string
AccountType - integer
RoutingNumber - string
AccountNumber - string
ConfirmAccountNumber - string
AccountType options: 0 - Unknown, 1 - PersonalSavings, 2 - PersonalChecking, 3 - BusinessChecking, 4 - BusinessSavings
Accertify object
SessionId - string
UbaId - string
UbaSessionId - string
PageId - string
UbaEvents - string
DevTID - string
Accertify values used for the Account Update API call.

Output

If the input parameters are not valid, you will receive a 400 BadRequest and a validation message indicating the reason.

If there are no errors with the input parameters, this call will respond with a 200 OK and a success message.

If there are errors, you will receive a 404 NotFound with an error message indicating the reason.