SBA Grant Platform - API HTTP Response Codes

The SBA Loan Forgiveness Platform REST APIs return either 200 (OK) , 201 (Created) or 204 when an API request successfully runs to completion. Status codes in the 400-500 range indicate failures

List of HTTP Error Codes:

Method API Error code & Error Message Error Description
POST /grants Default REST errors Default REST errors
POST /grants {“business_type”: {“field”: “business_type”,”verbose”: “Business Type”,”errors”: [{“ref_code”: “B0011”,”msg”: “Field is missing or unanswered”}]} business_type is missing
POST /grants {“business”:{“tin”:[“This field is required.”]}} Business tin is missing
POST /grants {“business”:{“tin_type”:[“This field is required.”]}} Business tin_type is missing
POST /grants {“phone_number”:{“field”:”phone_number”,”verbose”:”Phone Number”,”errors”:[{“ref_code”:”B0006”,”msg”:”Phone Number is required”}]}} Business phone_number is missing
POST /grants {“restaurant_type”: {“field”: “restaurant_type”,”verbose”: “Restaurant Type”,”errors”: [{“ref_code”: “B1007”,”msg”: “Restaurant Type is required”}]}} restaurant_type is missing
POST /grants {“is_franchise”:{“field”:”is_franchise”,”verbose”:”The Business is a franchise that is listed in the SBA’s Franchise Directory”,”errors”:[{“ref_code”:”B0011”,”msg”:”Field is missing or unanswered”}]}} is_franchise is missing
POST /grants {“zip_code”:{“field”:”zip_code”,”verbose”:”Zip”,”errors”:[{“ref_code”:”B0011”,”msg”:”Field is missing or unanswered”}]}} zip_code is missing
POST /grants {“tin”:{“field”:”tin”,”verbose”:”TIN”,”errors”:[{“ref_code”:”BO0001”,”msg”:”Field is missing or unanswered for Business Owner (None)”}]}} owner tin is missing
POST /grants {“detail”:”Please provide the signer email address”} signer_email is missing
POST /grants {“detail”:”Please provide routing number for bank account”} routing_number is missing
POST /grants {“detail”:”Please provide the bank account number”} account_number is missing
POST /grants {“business”: {“ownership_percentage”: [“Ownership Percentage must be a valid number”]}} ownership_percentage is missing
POST /grants {“address_line_1”: {“field”: “address_line_1”,”verbose”: “Address Line 1”,”errors”: [{“ref_code”: “BO0001”,”msg”: “Field is missing or unanswered for Business Owner “}]}} owner address_line_1 is missing
POST /grants {“address_line_1”: {“field”: “address_line_1”,”verbose”: “Address Line 1”,”errors”: [{“ref_code”: “B0011”,”msg”: “Field is missing or unanswered”}]}} Business address_line_1 is missing
POST /grants { “city”: {“field”: “city”,”verbose”: “City”,”errors”: [{“ref_code”: “B0011”,”msg”: “Field is missing or unanswered”}]}} Business city is missing
POST /grants {“state”: {“field”: “state”,”verbose”: “State”,”errors”: [{“ref_code”: “B0011”,”msg”: “Field is missing or unanswered”}]}} Business state is missing
POST /grants {“zip_code”: {“field”: “zip_code”,”verbose”: “Zip”,”errors”: [{“ref_code”: “B0011”,”msg”: “Field is missing or unanswered”}]}} Business zip_code is missing
POST /grants {“tin”: {“field”: “tin”,”verbose”: “TIN”,”errors”: [{“ref_code”: “BO0001”,”msg”: “Field is missing or unanswered for Business Owner “}]}} Owner tin is missing
POST /grants { “tin_type”: {“field”: “tin_type”,”verbose”: “TIN Type”,”errors”: [ { “ref_code”: “BO0001”, “msg”: “Field is missing or unanswered for Business Owner “ }] }} owner tin_type is missing
POST /grants { “state”: {“field”: “state”,”verbose”: “State”,”errors”: [{ “ref_code”: “BO0001”, “msg”: “Field is missing or unanswered for Business Owner”}] }} owner state is missing
POST /grants {“zip_code”: {“field”: “zip_code”,”verbose”: “Zip”,”errors”: [{“ref_code”: “BO0001”,”msg”: “Field is missing or unanswered for Business Owner”}]}} owner zip_code is missing
POST /grants {“city”: {“field”: “city”,”verbose”: “City”,”errors”: [{“ref_code”: “BO0001”,”msg”: “Field is missing or unanswered for Business Owner Carol carolson”}]}} owner city is missing
POST /grants {“business”: { “bankrupt_eligible”: { “field”: “bankrupt_eligible”, “verbose”: “Bankruptcy Eligibility”, “errors”: [ {“ref_code”: “G0019”,”msg”: “Bankruptcy status must be indicated” } ] }}} applicant_filed_bankruptcy status is missing
POST /grants {“months_in_operation”: { “field”: “months_in_operation”, “verbose”: “Number of months in operation”, “errors”: [ {“ref_code”: “G0008”,”msg”: “Months in operation must be provided when date of first sale is after 01/01/2019” } ]}} Months in operation must be provided for calc method 2
POST /grants {“business”:{“legal_name”:[“Must be less than 80 characters (non-alphanumeric characters will count as 2 characters)”,”Ensure this field has no more than 80 characters.”]}} legal_name length greater than permitted length
POST /grants {“business”:{“tin”:[“Ensure this field has no more than 9 characters.”]}} business tin length greater than permitted length
POST /grants {“business”:{“phone_number”:[“Phone number must be 10 digits.”]}} phone_number length greater than permitted length
POST /grants {“business”:{“zip_code”:[“Ensure this field has no more than 5 characters.”]}} zip_code length greater than permitted length
POST /grants {“business”:{“zip_code_plus4”:[“Ensure this field has no more than 4 characters.”]}} zip_code_plus4 length greater than permitted length
POST /grants {“business”:{“owners”:[{“tin”:[“Ensure this field has no more than 9 characters.”]}]}} Owner tin length greater than permitted length
POST /grants {“grant_amount”:[“Ensure that there are no more than 10 digits before the decimal point.”]} grant_amount length greater than permitted length
POST /grants {“signer_first_name”:[“Must be less than 80 characters (non-alphanumeric characters will count as 2 characters)”,”Ensure this field has no more than 80 characters.”]} signer_first_name length greater than permitted length
POST /grants {“signer_last_name”:[“Must be less than 80 characters (non-alphanumeric characters will count as 2 characters)”,”Ensure this field has no more than 80 characters.”]} signer_last_name length greater than permitted length
POST /grants {“signer_phone_number”:[“Phone number must be 10 digits.”]} signer_phone_number length greater than permitted length
POST /grants {“signer_title”:[“Must be less than 80 characters (non-alphanumeric characters will count as 2 characters)”,”Ensure this field has no more than 80 characters.”]} signer_title length greater than permitted length
POST /grants {“signer_address_line_1”:[“Must be less than 80 characters (non-alphanumeric characters will count as 2 characters)”,”Ensure this field has no more than 80 characters.”]} signer_address_line_1 length greater than permitted length
POST /grants {“signer_address_line_2”:[“Must be less than 80 characters (non-alphanumeric characters will count as 2 characters)”,”Ensure this field has no more than 80 characters.”]} signer_address_line_2 length greater than permitted length
POST /grants {“signer_city”:[“Ensure this field has no more than 40 characters.”]} signer_city length greater than permitted length
POST /grants {“signer_zip_code”:[“Ensure this field has no more than 5 characters.”]} signer_zip_code length greater than permitted length
POST /grants {“bank_account”:{“routing_number”:[“Numeric Values Required”,”Ensure this field has no more than 255 characters.”]}} routing_number length greater than permitted length
POST /grants {“bank_account”:{“account_number”:[“Numeric Values Required”,”Ensure this field has no more than 255 characters.”]}} account_number length greater than permitted length
POST /grants {“business”:{“state”:[”” is not a valid choice.”]}} State with invalid value
POST /grants {“business”:{“owners”:[{“state”:[”” is not a valid choice.”]}]}} Owner State with invalid value
POST /grants {“date_of_first_sale”:[“Date has wrong format. Use one of these formats instead: YYYY-MM-DD.”]} date_of_first_sale with wrong format
POST /grants {“business”:{“restaurant_type”:{“0”:[”” is not a valid choice.”]}}} Invalid value for restaurant_type
POST /grants {“business”:{“owners”:[{“ownership_percentage”:[“Ensure this value is less than or equal to 100.0.”]}]}} ownership_percentage > 100
POST /grants {“business”:{“owners”:[{“ownership_percentage”:[“Ensure this value is greater than or equal to 1.0.”]}]}} ownership_percentage <1
POST /grants {“business”:{“total_ownership_percentage”:{“field”:”total_ownership_percentage”,”verbose”:”Total Ownership Percentage”,”errors”:{“ref_code”:”E0035”,”msg”:”Total ownership percentage between all owners must be at least 20%.”}}}} ownership percentage aggregate across owner is less than 20 percent
POST /grants {“applicant_filed_bankruptcy”:[”” is not a valid choice.”]} Invalid applicant_filed_bankruptcy
POST /grants {“applicant_received_shuttered_venues_grant”:[“Must be a valid boolean.”]} Invalid applicant_received_shuttered_venues_grant
POST /grants {“number_of_affiliated_businesses”:[“A valid integer is required.”]} Invalid number_of_affiliated_businesses
POST /grants {“applicant_operates_over_20_locations”:[“Must be a valid boolean.”]} Invalid applicant_operates_over_20_locations
POST /grants {“applicant_owned_by_gov_entity”:[“Must be a valid boolean.”]} Invalid applicant_owned_by_gov_entity
POST /grants {“applicant_has_affiliated_businesses”:[“Must be a valid boolean.”]} Invalid applicant_has_affiliated_businesses
POST /grants {“priority_group_women_owned”:[“Must be a valid boolean.”]} Invalid priority_group_women_owned
POST /grants {“priority_group_veteran”:[“Must be a valid boolean.”]} Invalid priority_group_veteran
POST /grants {“priority_group_socio_economic”:[“Must be a valid boolean.”]} Invalid priority_group_socio_economic
POST /grants {“grant_purpose_payroll”:[“Must be a valid boolean.”]} Invalid grant_purpose_payroll
POST /grants {“grant_purpose_rent”:[“Must be a valid boolean.”]} Invalid grant_purpose_rent
POST /grants {“grant_purpose_utility”:[“Must be a valid boolean.”]} Invalid grant_purpose_utility
POST /grants {“grant_purpose_debt”:[“Must be a valid boolean.”]} Invalid grant_purpose_debt
POST /grants {“grant_purpose_construction_outdoor_seating”:[“Must be a valid boolean.”]} Invalid grant_purpose_construction_outdoor_seating
POST /grants {“grant_purpose_supplies”:[“Must be a valid boolean.”]} Invalid grant_purpose_supplies
POST /grants {“grant_purpose_food”:[“Must be a valid boolean.”]} Invalid grant_purpose_food
POST /grants {“grant_purpose_operations”:[“Must be a valid boolean.”]} Invalid grant_purpose_operations
POST /grants {“grant_purpose_covered_supplier”:[“Must be a valid boolean.”]} Invalid grant_purpose_covered_supplier
POST /grants {“grant_amount”:[“A valid number is required.”]} Invalid grant_amount
POST /grants {“business”:{“tin_type”:[”” is not a valid choice.”]}} Invalid value for tin_type - Business
POST /grants {“business”: {“owners”: [{“owner_type”: [”” is not a valid choice.”]}]}} Invalid value for tin_type - Owner
POST /grants {“business”:{“business_type”:[”” is not a valid choice.”],”tin_type”:[“This field is required.”]}} Invalid value for business_type
POST /grants { “business”: {“owners”: [{ “gender”: [ “” is not a valid choice.” ]}] }} Incorrect value for Gender
POST /grants { “business”: {“owners”: [{ “ethinicity”: [ “” is not a valid choice.” ]}] }} Incorrect value for Ethinicity
POST /grants {“business”: {“owners”: [{ “race”: { “0”: [ “” is not a valid choice.” ] }}]}} Incorrect value for Race
POST /grants {“has_grant_purpose”:{“field”:”non_field_errors”,”verbose”:”Grant Purpose”,”errors”:[{“ref_code”:”G0003”,”msg”:”At least one grant purpose must be selected”}]}} All grant purpose false
POST /grants {“business”:{“null”:{“field”:”non_field_errors”,”verbose”:”Duplicate Owners”,”errors”:[{“ref_code”:”E0034”,”msg”:”You are attempting to duplicate an owner/TIN.”}]}}} Owner TIN cannot be same as Business TIN (other than business type sole prop, independent contractor, self employed or LLC using SSN where its allowed) else this error will be displayed
POST /grants {“tin”: {“field”: “tin”,”verbose”: “TIN”,”errors”: [{ “ref_code”: “E0096”, “msg”: “Our automated routines have determined that there is a mismatch between business SSN and principal SSN. Please ensure that the correct SSN is used for both the business and principal.”}] }} Mismatch between owner and business tin for business type 1,16,17
POST /grants {“applicant_owned_by_gov_entity”:{“field”:”applicant_owned_by_gov_entity”,”verbose”:”Applicant is owned by state, local, or municipal government entity”,”errors”:[{“ref_code”:”G0002”,”msg”:”Applicant is ineligible to receive a Restaurant Grant”}]}} Eligibility critirea true for applicant_owned_by_gov_entity
POST /grants {“applicant_operates_over_20_locations”:{“field”:”applicant_operates_over_20_locations”,”verbose”:”Applicant owns or operates over 20 locations”,”errors”:[{“ref_code”:”G0002”,”msg”:”Applicant is ineligible to receive a Restaurant Grant”}]}} Eligibility critirea true for applicant_operates_over_20_locations
POST /grants {“applicant_received_shuttered_venues_grant”:{“field”:”applicant_received_shuttered_venues_grant”,”verbose”:”Applicant Applied or Received Shuttered Venues Grant”,”errors”:[{“ref_code”:”G0002”,”msg”:”Applicant is ineligible to receive a Restaurant Grant”}]}} Eligibility critirea true for applicant_received_shuttered_venues_grant
POST /grants {“applicant_issues_securities”:{“field”:”applicant_issues_securities”,”verbose”:”Applicant Issues Securities”,”errors”:[{“ref_code”:”G0002”,”msg”:”Applicant is ineligible to receive a Restaurant Grant”}]}} Eligibility critirea true for applicant_publicly_traded
POST /grants {“applicant_business_permanently_closed”:{“field”:”applicant_business_permanently_closed”,”verbose”:”Applicant’s Business has permanently closed”,”errors”:[{“ref_code”:”G0002”,”msg”:”Applicant is ineligible to receive a Restaurant Grant”}]}} Eligibility critirea true for applicant_business_permanently_closed
POST /grants {“is_franchise”:{“field”:”is_franchise”,”verbose”:”Franchise Code”,”errors”:[{“ref_code”:”E0186”,”msg”:”Franchise Code is required and must be listed in the SBA franchise directory”}]}} is franchise true and franchise code not provided
POST /grants {“number_of_affiliated_businesses”:{“field”:”number_of_affiliated_businesses”,”verbose”:”Number of affiliated businesses”,”errors”:[{“ref_code”:”G0004”,”msg”:”Applicant has specified that it has affiliated businesses, and must provide the number of affiliated businesses”}]}} number_of_affiliated_businesses is mandatory when applicant_has_affiliated_businesses is true.
POST /grants {“affiliated_businesses_details”:{“field”:”affiliated_businesses_details”,”verbose”:”Affiliated Businesses - Entity Names”,”errors”:[{“ref_code”:”G0005”,”msg”:”Applicant has specified that it has affiliated businesses, and must provide the names of affiliated businesses”}]}} affiliated_businesses_details is mandatory when applicant_has_affiliated_businesses is true.
POST /grants {“title”:{“field”:”title”,”verbose”:”Title”,”errors”:[{“ref_code”:”BO0001”,”msg”:”Field is missing or unanswered for Business Owner “}]}} Owner Title is not provided in request
POST /grants {“date_of_operation”: {“field”: “date_of_operation”,”verbose”: “Date of Operation/ Date of First Sale”,”errors”: [{“ref_code”: “G3008”,”msg”: “Date of Operation / Date of First Sale must be on or after 01/01/2019 for the chosen grant calculation method”}]}} Date of First Sale is not on or after 01/01/2019 for the chosen grant calculation method 2
POST /grants ”{““date_of_operation””: {““field””: ““date_of_operation””,”“verbose””: ““Date of Operation/ Date of First Sale””,”“errors””: [{““ref_code””: ““G2008””,”“msg””: ““Date of Operation / Date of First Sale must be on or after 01/01/2020 for the chosen grant calculation method””}]}}” Date of First Sale is not on or after 01/01/2020 for the chosen grant calculation method 3
POST /grants ”{““date_of_operation””: {““field””: ““date_of_operation””,”“verbose””: ““Date of Operation/ Date of First Sale””,”“errors””: [{““ref_code””: ““G1008””,”“msg””: ““Date of Operation / Date of First Sale must be on or before 01/01/2019 for the chosen grant calculation method””}]}}” Date of First Sale is not on or before 01/01/2019 for the chosen grant calculation method 1
POST /grants {“date_of_first_sale”:[“This field is required.”]} Data of first sale not provided for calculation method 1,2,3.
POST /grants {“business”:{“phone_number”:[“Phone number must be 10 digits.”]}} Business phone number length more than 10 digits.
POST /grants {“applicant_suspended_or_debarred”: {“field”: “applicant_suspended_or_debarred”,”verbose”: “Applicant is suspended or debarred”,”errors”: [{“ref_code”: “G0002”,”msg”: “Applicant is ineligible to receive a Restaurant Grant”}]} applicant_suspended_or_debarred is true
POST /grants ”{““business””: {““bankrupt_eligible””: {““field””: ““bankrupt_eligible””,”“verbose””: ““Bankruptcy Eligibility””,”“errors””: [{““ref_code””: ““G0020””,”“msg””: ““Bankruptcy value selected is an ineligible status””}]}}}” Value 2,3 selected for applicant_filed_bankruptcy field
POST /grants {“tin_type”: { “field”: “tin_type”, “verbose”: “TIN Type”, “errors”: [ {“ref_code”: “E0431”,”msg”: “You have used a TIN Type that conflicts with the selected business type, please ensure these are aligned and attempt your transaction again.” } ]}} Tin type and business type conflicts
POST /grants {“first_name”: {“field”: “first_name”,”verbose”: “First Name”,”errors”: [{“ref_code”: “B0005”,”msg”: “First Name should be provided”}]},”last_name”: {“field”: “last_name”,”verbose”: “Last Name”,”errors”: [{“ref_code”: “B0005”,”msg”: “Last Name should be provided”}]}} When first/Last Name not provided for tin type SSN
POST /grants { “legal_name”: {“field”: “legal_name”,”verbose”: “Legal Name”,”errors”: [{“ref_code”: “B0004”,”msg”: “Business Legal Name should be provided”}]}} Business Legal Name not provided when tin type is EIN.
POST /grants {“bank_account”: {“account_type”: [”” is not a valid choice.”]}} Invalid Account type provided in bank account details
POST /grants “address”: {“field”: “address”,”verbose”: “Business Address”,”errors”: [{“ref_code”: “E02743”,”msg”: “Our automated routines have determined that you have utilized a PO Box for the Business Address. The SBA does not support the entry of a PO Box. Please update this address and resubmit your application.”}]} PO Box address is not allowed for Business.
POST /grants { “months_in_operation”: [“Ensure this value is less than or equal to 12.”]} Months in Operation provided is more than 12
POST /grants {“months_in_operation”: [“Ensure that there are no more than 1 decimal places.”]} Months in Operation having more than 1 decimal place
POST /grants {“months_in_operation”: [“Ensure that there are no more than 3 digits in total..”]} Months in Operation having more than 3 digits
POST /grants {“business”: {“owners”: [{ “zip_code”: [ “Numeric Values Required”, “Ensure this field has no more than 5 characters.” ]}]},”bank_account”: {“account_type”: [”"checkin1g" is not a valid choice.”]},”months_in_operation”: [“Ensure that there are no more than 3 digits in total.”]} Non-numeric character in owner zip code
POST /grants {“business”: {“owners”: [{ “zip_code_plus4”: [ “Numeric Values Required”, “Ensure this field has no more than 5 characters.” ]}]},”bank_account”: {“account_type”: [”"checkin1g" is not a valid choice.”]},”months_in_operation”: [“Ensure that there are no more than 3 digits in total.”]} Non-numeric character in owner zip code plus 4
POST /grants { “business”: {“owners”: [{ “tin”: [ “Numeric Values Required”, “Ensure this field has no more than 9 characters.” ]}]},} Owner tin having non-numeric character
POST /grants {“business”: {“owners”: [{“ownership_percentage”: [“A valid number is required.”]}]}} Ownership percentage not having valid number
POST /grants {“period_1_revenue”: {“field”: “period_1_revenue”,”verbose”: “Gross Receipts 2019”,”errors”: [{“ref_code”: “G0019”,”msg”: “Gross Receipts 2019 must be provided”}]}} Gross Receipts 2019 must be provided for calc method 1,2
POST /grants {“period_2_revenue”: { “field”: “period_2_revenue”, “verbose”: “Gross Receipts 2020”, “errors”: [ { “ref_code”: “G0010”, “msg”: “Gross Receipts 2020 must be provided” } ]}} Gross Receipts 2020 must be provided for calc method 1,2
POST /grants {“gross_receipts_signature_date”: { “field”: “gross_receipts_signature_date”, “verbose”: “Gross Receipts as of Signature Date”, “errors”: [ {“ref_code”: “G0012”,”msg”: “Gross Receipts as of signature date must be provided” } ]}} Gross Receipts as of signature date must be provided for calc method 2
POST /grants {“grant_amount”: {“field”: “grant_amount”,”verbose”: “Grant Amount”,”errors”: [{“ref_code”: “G0022”,”msg”: “2019 gross receipts need to be more than 2020 gross receipts to be eligible for a grant”}]}} 2019 gross receipts need to be more than 2020 gross receipts to be eligible for a grant
POST /grants {“owner_type”: {“field”: “owner_type”,”verbose”: “Owner Type”,”errors”: [{“ref_code”: “E0025”,”msg”: “The owner type for the business selected should be an individual.”}]} The owner type for the business selected should be an individual.
POST /grants ”{ ““owner_type””: {““field””: ““owner_type””,”“verbose””: ““Owner Type””,”“errors””: [ { ““ref_code””: ““E0026””, ““msg””: ““The business owner type you selected requires a Social Security Number.”” }] }} “ The business owner type you selected requires a Social Security Number.
POST /grants {“business_name”: {“field”: “business_name”,”verbose”: “Business Name”,”errors”: [{“ref_code”: “E0027”,”msg”: “The Business type you selected does not allow a Business name associated with an SSN.”}]}} The Business type you selected does not allow a Business name associated with an SSN.
POST /grants {“tin_type”: {“field”: “tin_type”,”verbose”: “Tin Type”,”errors”: [{“ref_code”: “E0126”,”msg”: “The owner type you selected requires an EIN.”}]}, The owner type you selected requires an EIN.
POST /grants {“business_name”: {“field”: “business_name”,”verbose”: “Business Name”,”errors”: [{“ref_code”: “E0028”,”msg”: “The Business type you selected requires a Business Name for the business owner.”}]}} The Business type you selected requires a Business Name for the business owner.
POST /grants {“tin_type”: {“field”: “tin_type”,”verbose”: “TIN Type”,”errors”: [{ “ref_code”: “E0037”, “msg”: “The business owner selected for this type of business must have a SSN, not an EIN.”}] },} The business owner selected for this type of business must have a SSN, not an EIN.
POST /grants {“first_name”: {“field”: “first_name”,”verbose”: “First Name”,”errors”: [{“ref_code”: “E0039”,”msg”: “The Business type you selected must not provide a First Name for the business owner.”}]}} The Business type you selected must not provide a First Name for the business owner
POST /grants {“last_name”: {“field”: “last_name”,”verbose”: “Last Name”,”errors”: [{“ref_code”: “E0040”,”msg”: “The Business type you selected must not provide a Last Name for the business owner.”}]}} The Business type you selected must not provide a Last Name for the business owner.
POST /grants {“first_name”: {“field”: “first_name”,”verbose”: “First Name”,”errors”: [{“ref_code”: “E0029”,”msg”: “The Business type you selected requires a First and last name for the business owner.”}]}} The Business type selected requires a First and last name for the business owner.
POST /grants {“business_type”: {“field”: “business_type”,”verbose”: “Business Type”,”errors”: [{“ref_code”: “E0131”,”msg”: “Our automated routines have determined that the business type for an owner was not included. Please verify the owner information and resubmit.”}]} Business type for an owner was not included when owner/business are BUSINESS.
POST /grants {“tin”: {“field”: “tin”,”verbose”: “TIN”,”errors”: [{ “ref_code”: “E0136”, “msg”: “Our automated routines have determined that ITIN is likely invalid.”}] }} Our automated routines have determined that ITIN is likely invalid.
POST /grants {“ownership_percentage”: {“field”: “ownership_percentage”,”verbose”: “Ownership Percentage”,”errors”: [{ “ref_code”: “E0196”, “msg”: “Our automated routines have determined that there is likely a problem with the principal ownership percentage. Please ensure that the ownership percentage for this business type equals 100%.”}] }} ownership_percentage is not 100 for business type 1, 16, 17.
POST /grants {“tin”: { “field”: “tin”, “verbose”: “TIN”, “errors”: [ {“ref_code”: “E0035”,”msg”: “Invalid Business Owner TIN” } ]}} Invalid Business Owner TIN
POST /grants {“tin”: { “field”: “tin”, “verbose”: “TIN”, “errors”: [{ “ref_code”: “E01040”, “msg”: “Our automated routines have determined that Business TIN is likely invalid.”} ]}} Business TIN is likely invalid
POST /grants {“tin”: { “field”: “tin”, “verbose”: “TIN”, “errors”: [{ “ref_code”: “E02041”, “msg”: “Our automated routines have determined that ITIN is likely invalid.”} ]}} Business ITIN is likely invalid
POST /grants {“tin_type”: {“field”: “tin_type”,”verbose”: “TIN Type”,”errors”: [{“ref_code”: “E0430”,”msg”: “You have used a TIN Type that conflicts with the selected business type, please ensure these are aligned and attempt your transaction again.”}]}} TIN Type conflicts with the selected business type - Business Tin type is EIN and business type is 16,17.
POST /grants {“tin_type”: {“field”: “tin_type”,”verbose”: “TIN Type”,”errors”: [{“ref_code”: “E0431”,”msg”: “You have used a TIN Type that conflicts with the selected business type, please ensure these are aligned and attempt your transaction again.”}]}} “TIN Type conflicts with the selected business type -Business Tin type is SSN/ITIN and business type not in below business types:INDEPENDENT_CONTRACTOR,ELIG_SELF_EMPLOYED,SOLE_PROPRIETOR,TENANT_IN_COMMON,LLC,SINGLE_MEMBER_LLC,QUALIFIED_JOINT_VENTURE,TRUST]:”
POST /grants {“first_name”: { “field”: “first_name”, “verbose”: “First Name”, “errors”: [ { “ref_code”: “B0003”, “msg”: “First Name should be provided for Sole Prop” } ]}} First Name should be provided for Sole Prop
POST /grants {“last_name”: { “field”: “last_name”, “verbose”: “Last Name”, “errors”: [ { “ref_code”: “B0003”, “msg”: “Last Name should be provided for Sole Prop” } ]}} Last Name should be provided for Sole Prop
POST /grants {“legal_name”: {“field”: “legal_name”,”verbose”: “Legal Name”,”errors”: [{“ref_code”: “B0004”,”msg”: “Business Legal Name should be provided”}]}} Business Legal Name should be provided
POST /grants {“last_name”: { “field”: “last_name”, “verbose”: “Last Name”, “errors”: [ { “ref_code”: “B0007”, “msg”: “Business type with EIN should not provide Last Name” } ]}} Business type with EIN should not provide Last Name
POST /grants {“first_name”: { “field”: “first_name”, “verbose”: “First Name”, “errors”: [ { “ref_code”: “B0008”, “msg”: “Business type with EIN should not provide First Name” } ]}} Business type with EIN should not provide First Name
POST /grants {“business”: { “owners”: {“field”: “owners”,”verbose”: “Owners”,”errors”: { “ref_code”: “E0032”, “msg”: “The maximum number of owners is twenty (20) and each owner should have at least 1% ownership.”} }}} More than 20 owners provided in the request
POST /grants {“business”: {“total_ownership_percentage”: {“field”: “total_ownership_percentage”,”verbose”: “Total Ownership Percentage”,”errors”: {“ref_code”: “E0033”,”msg”: “Total ownership percentage between all owners cannot exceed 100%.”}}}} Total ownership percentage between all owners cannot exceed 100%
POST /grants {“date_of_operation”: { “field”: “date_of_operation”, “verbose”: “Date of Operation/ Date of First Sale”, “errors”: [ {“ref_code”: “G0016”,”msg”: “Date of Operation / Date of First Sale must not be in the future” } ]}} Date of First Sale must not be in the future
POST /grants {“not_accepting_grants”: { “field”: “not_accepting_grants”, “verbose”: “Not Accepting Grants”, “errors”: [ {“ref_code”: “G9999”,”msg”: “The site is currently not accepting new grants.” } ]}} When no more grants are accepted
POST /grants {“business”: { “number_of_affiliated_businesses”: {“field”: “number_of_affiliated_businesses”,”verbose”: “Inconsistent affiliated businesses data”,”errors”: [{ “ref_code”: “G0014”, “msg”: “Applicant has provided data relevant only when there are affiliated businesses. However the data provided did not indicate that the business does have affiliated businesses.”}] }}} When applicant_has_affiliated_businesses is false and data provided in number_of_affiliated_businesses
POST /grants ”{ ““message””: ““Our automated routines have determined that there are errors that have prevented this data from saving, which may include the business having already applied for a RRF Grant. Please validate the business and business owner information and resubmit. E0482””}” Same business tin/tin type already submitted.
POST /grants ”{““ppp_first_draw_sba_loan_number””: { ““field””: ““ppp_first_draw_sba_loan_number””, ““verbose””: ““PPP First Draw Loan Number””, ““errors””: {““ref_code””: ““G1111””,”“msg””: ““PPP First Draw Loan Number must be validated when using Calculation Method 4. SBA # «SBA Number», Loan Amount: «Loan Amount»”” }},”“ppp_second_draw_sba_loan_number””: { ““field””: ““ppp_second_draw_sba_loan_number””, ““verbose””: ““PPP Second Draw Loan Number””, ““errors””: {““ref_code””: ““G1112””,”“msg””: ““PPP Second Draw Loan Number must be validated when using Calculation Method 4. SBA # «SBA Number», Loan Amount: «Loan Amount»”” }}}” Table 4: If ppp record exists but not provided - First Draw/Second Draw
POST /grants ”{““ppp_first_draw_sba_loan_number””: { ““field””: ““ppp_first_draw_sba_loan_number””, ““verbose””: ““PPP First Draw Loan Number””, ““errors””: {““ref_code””: ““G1111””,”“msg””: ““PPP First Draw Loan Number must be validated when using Calculation Method 4. SBA # «SBA Number», Loan Amount: «Loan Amount»”” }},”“ppp_second_draw_sba_loan_number””: { ““field””: ““ppp_second_draw_sba_loan_number””, ““verbose””: ““PPP Second Draw Loan Number””, ““errors””: {““ref_code””: ““G1112””,”“msg””: ““PPP Second Draw Loan Number must be validated when using Calculation Method 4. SBA # «SBA Number», Loan Amount: «Loan Amount»”” }}}” Table 4: If incorrect first draw/Second ppp data provided
POST /grants ”{““ppp_first_draw_sba_loan_number””: { ““field””: ““ppp_first_draw_sba_loan_number””, ““verbose””: ““PPP First Draw Loan Number””, ““errors””: {““ref_code””: ““G1111””,”“msg””: ““PPP First Draw Loan Number must be validated when using Calculation Method 4. SBA # «SBA Number», Loan Amount: «Loan Amount»”” }},”“ppp_second_draw_sba_loan_number””: { ““field””: ““ppp_second_draw_sba_loan_number””, ““verbose””: ““PPP Second Draw Loan Number””, ““errors””: {““ref_code””: ““G1112””,”“msg””: ““PPP Second Draw Loan Number must be validated when using Calculation Method 4. SBA # «SBA Number», Loan Amount: «Loan Amount»”” }}}” Table 4: If valid ppp sba number provided but not linked to the tin number
POST /grants {“loan_number”: {“field”: “loan_number”,”verbose”: “Additional PPP Loan Number”,”errors”: {“ref_code”: “G1121”,”msg”: “Additional PPP Loan Number «Number» could not be found. Please check the loan number and resubmit.”}} Table 4: Additional PPP loan amount incorrect
POST /grants ”{““ppp_first_draw_sba_loan_number””: { ““field””: ““ppp_first_draw_sba_loan_number””, ““verbose””: ““PPP First Draw Loan Number””, ““errors””: {““ref_code””: ““G1115””,”“msg””: ““No PPP draw information was provided, but PPP history was found. Please validate and resubmit. SBA # «SBA Number», Loan Amount: «Loan Amount»”” }}}” Table 4: If ppp record exists but not provided - First Draw
POST /grants {“months_in_operation”: { “field”: “months_in_operation”, “verbose”: “Months in Operation”, “errors”: [ {“ref_code”: “G1009”,”msg”: “Months in operation must be at least 1 for the provided date of first sale.” } ]}} Table 2 : Months in Operation should not be less than 1. Minimum acceptable value for Months in operation is 1.
POST /grants {‘months_in_operation’: {‘field’: ErrorDetail(string=’months_in_operation’, code=’invalid’), ‘verbose’: ErrorDetail(string=’Months in Operation’, code=’invalid’), ‘errors’: [{‘ref_code’: ErrorDetail(string=’G1009’, code=’invalid’), ‘msg’: ErrorDetail(string=’Months in operation must be at least «months» for the provided date of first sale.’, code=’invalid’)}]}} If the no of months is not taking till end of the year 2019 from the operations start date
POST /grants {‘months_in_operation’: {‘field’: ErrorDetail(string=’months_in_operation’, code=’invalid’), ‘verbose’: ErrorDetail(string=’Months in Operation’, code=’invalid’), ‘errors’: [{‘ref_code’: ErrorDetail(string=’G1010’, code=’invalid’), ‘msg’: ErrorDetail(string=’Your calculated months in operation exceeds 12 months for the provided date of first sale. Please review the date of first sale or choose a different calculation method’, code=’invalid’)}]} For table 2, if the start date of operation is before 2019