Don't forget to come by and check out our new RESTful JSON APIs, they can help you utilize and extend Quick Base with ease.



Use API_GetUserInfo to get the username and user ID associated with an email address used for Quick Base sign in. You invoke this call on db/main. You can use this call to grant  a user access rights to your application and then invite that user to your application. This call is typically made to return the Quick Base user ID for a user whose email address you know, in preparation for subsequent calls to API_AddUserToRole (grant access rights) and API_SendInvitation, both of which require the user ID.

The user email that you specify must be recognized in Quick Base. (For users who aren’t registered in Quick Base yet, use the alternative call API_ProvisionUser.)

For anonymous users, this call returns:

<user id="1.ckbs">

If the anonymous user passes in an email parameter, the email will be passed back in the response.

If you don’t supply an email parameter, the ticket parameter will be used to determine the current user, which means the current user ID, name, and email are returned.


Request parameters



A valid authentication ticket.

The authentication ticket is returned via the API_Authenticate call.



The user token is an alternative means of authentication, used for API access. User tokens cannot be used to access the Quick Base UI.

yes, one of:

  • ticket
  • username/password
  • user token


A valid application token

yes, if the application requires application tokens


Supply the email address (as registered with Quick Base) of the user whose information you want. You can also supply the user’s user name.

If you don’t supply this parameter, the call returns the user info of the user to whom the ticket was issued (you).

For anonymous users, the email parameter is ignored.



A string value that you want returned. It will not be handled by Quick Base but it will be returned in the response.



Response values

Element NameValue


Echoes the originating request, for example, API_AddField.


Identifies the error code, if any. (See the Error Codes appendix for a list of possible error codes.)

0 indicates that no error was encountered.


Text that explains the error code.

"No error" indicates that no error was encountered.


The ticket needed for application access.


The returned user aggregate. This aggregate always contains the user ID attribute and the user name. The user aggregate also contains the user login if the email parameter was NOT specified in the request. The login will be any of the following:

  • The user's LDAP login, if applicable

  • The user's Quick Base screen (user) name, if LDAP is not being used

  • The user's email address, if the user has no LDAP login or Quick Base user name

The aggregate is structured as follows:

<user id="56760756.bpxd">


Optional. Contains any udata value supplied in the request.


Sample XML Request

POST https://target_domain/db/main HTTP/1.0
Content-Type: application/xml

   <udata>optional data</udata>


URL alternative


where target_domain is the domain against which you are invoking this call, for example, quickbase.com. Read about this notation.


Sample response

<?xml version="1.0" ?>
   <errtext>No error</errtext>
   <user id="112149.bhsv">