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 |