GunBroker.com Auctions Web Service

The GunBroker.com SOAP API will be deprecated.  Please start using our REST API for your applications.

Click here for a complete list of operations.

GetUser

Get information about a user. Fill out either the UserID or UserName. If you have been involved in a transaction with that user, you will be provided their contact information. If you have not had any transactions with the user the call will fail with an error message, however if you fill out the UserName it will always succeed if the UserName is found and return only the UserID.

Test

The test form is only available for requests from the local machine.

SOAP 1.1

The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.

POST /AuctionService.asmx HTTP/1.1
Host: apiv2.gunbroker.com
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "GunBrokerAPI_V2/GetUser"

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Header>
    <RequesterCredentials xmlns="GunBrokerAPI_V2">
      <DevKey>string</DevKey>
      <AppKey>string</AppKey>
    </RequesterCredentials>
  </soap:Header>
  <soap:Body>
    <GetUser xmlns="GunBrokerAPI_V2">
      <GetUserRequest>
        <UserID>int</UserID>
        <UserName>string</UserName>
      </GetUserRequest>
    </GetUser>
  </soap:Body>
</soap:Envelope>
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <GetUserResponse xmlns="GunBrokerAPI_V2">
      <GetUserResult>
        <Timestamp>dateTime</Timestamp>
        <Ack>Success or Failure or Warning</Ack>
        <Errors>
          <ShortMessage>string</ShortMessage>
          <LongMessage>string</LongMessage>
          <ErrorCode>string</ErrorCode>
        </Errors>
        <User>
          <HadTransactionWithUser>boolean</HadTransactionWithUser>
          <UserID>int</UserID>
          <Status>int</Status>
          <UserName>string</UserName>
          <FeedbackScore>int</FeedbackScore>
          <FeedbackRating>decimal</FeedbackRating>
          <FeedbackDisplay>string</FeedbackDisplay>
          <RegistrationDate>dateTime</RegistrationDate>
          <Email>string</Email>
          <HomePhone>string</HomePhone>
          <FirstName>string</FirstName>
          <LastName>string</LastName>
          <Suffix>string</Suffix>
          <RegistrationAddress>string</RegistrationAddress>
          <ShippingAddress>string</ShippingAddress>
          <Address1>string</Address1>
          <Address2>string</Address2>
          <City>string</City>
          <State>string</State>
          <PostalCode>string</PostalCode>
          <CountryCode>string</CountryCode>
        </User>
      </GetUserResult>
    </GetUserResponse>
  </soap:Body>
</soap:Envelope>

SOAP 1.2

The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.

POST /AuctionService.asmx HTTP/1.1
Host: apiv2.gunbroker.com
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Header>
    <RequesterCredentials xmlns="GunBrokerAPI_V2">
      <DevKey>string</DevKey>
      <AppKey>string</AppKey>
    </RequesterCredentials>
  </soap12:Header>
  <soap12:Body>
    <GetUser xmlns="GunBrokerAPI_V2">
      <GetUserRequest>
        <UserID>int</UserID>
        <UserName>string</UserName>
      </GetUserRequest>
    </GetUser>
  </soap12:Body>
</soap12:Envelope>
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <GetUserResponse xmlns="GunBrokerAPI_V2">
      <GetUserResult>
        <Timestamp>dateTime</Timestamp>
        <Ack>Success or Failure or Warning</Ack>
        <Errors>
          <ShortMessage>string</ShortMessage>
          <LongMessage>string</LongMessage>
          <ErrorCode>string</ErrorCode>
        </Errors>
        <User>
          <HadTransactionWithUser>boolean</HadTransactionWithUser>
          <UserID>int</UserID>
          <Status>int</Status>
          <UserName>string</UserName>
          <FeedbackScore>int</FeedbackScore>
          <FeedbackRating>decimal</FeedbackRating>
          <FeedbackDisplay>string</FeedbackDisplay>
          <RegistrationDate>dateTime</RegistrationDate>
          <Email>string</Email>
          <HomePhone>string</HomePhone>
          <FirstName>string</FirstName>
          <LastName>string</LastName>
          <Suffix>string</Suffix>
          <RegistrationAddress>string</RegistrationAddress>
          <ShippingAddress>string</ShippingAddress>
          <Address1>string</Address1>
          <Address2>string</Address2>
          <City>string</City>
          <State>string</State>
          <PostalCode>string</PostalCode>
          <CountryCode>string</CountryCode>
        </User>
      </GetUserResult>
    </GetUserResponse>
  </soap12:Body>
</soap12:Envelope>